Construye sobre DataCred.
API REST con auditoría inmutable de cada consulta y cinco modelos de score calibrados para el riesgo crediticio venezolano. Registra tu empresa y, al aprobarla, crea tus API keys.
Del registro a tu primer pull en 5 minutos.
Haz un POST a /v1/public/partner-signup con los datos de tu empresa, tu documento fiscal (RIF / NIT), una contraseña y las cuatro confirmaciones legales explícitas. No envíes esos booleanos en true si el representante no ha visto y aceptado realmente los documentos enlazados en el registro web. Revisamos tu empresa en 1 a 2 días hábiles; al aprobarla recibes por correo el contrato de afiliación y 10 consultas de cortesía.
curl -X POST https://api.datacred.org/v1/public/partner-signup \
-H "Content-Type: application/json" \
-d '{
"company_name": "Mi Fintech CA",
"legal_name": "Mi Fintech, C.A.",
"tax_id": "J-12345678-9",
"industry": "LENDING",
"contact_email": "dev@mifintech.com",
"contact_full_name": "Nombre Ejemplo",
"password": "TuClaveSegura123",
"authorized_representative_attested": true,
"affiliation_contract_accepted": true,
"privacy_policy_acknowledged": true,
"data_processing_authorized": true
}'Con la empresa aprobada, entra al portal de socios y crea tu API key (dc_live_…). Se muestra una sola vez. DataCred tiene una sola clase de llave: toda key es real, consulta datos reales y sus consultas se cobran (las 10 primeras las pagan tus créditos de cortesía).
Busca por cédula (gratis) para obtener su userId y luego haz la consulta de evaluación. A la persona le llega un aviso de la consulta.
curl -X POST https://api.datacred.org/v1/partner/search \
-H "X-API-Key: dc_live_TU_KEY" \
-H "Content-Type: application/json" \
-d '{
"identity": { "documentNumber": "V-12345678", "fullName": "Ana Pérez" },
"purpose": "CREDIT_APPLICATION",
"legalBasisAttested": true,
"relationshipReference": "SOL-2026-000123"
}'
curl -X POST https://api.datacred.org/v1/partner/pull \
-H "X-API-Key: dc_live_TU_KEY" \
-H "Content-Type: application/json" \
-d '{
"userId": "<userId>",
"pullType": "SOFT",
"purpose": "CREDIT_APPLICATION",
"scoreModelId": "datacred_consumer"
}'Autenticación
Todos los endpoints de socios usan autenticación por API key. Envía tu key de una de estas dos formas:
X-API-Key: dc_live_…(recomendada para servidor a servidor)Authorization: Bearer dc_live_…
DataCred tiene una sola clase de API key: dc_live_…. Toda key consulta y reporta datos reales y sus consultas se cobran. Las keys dc_test_… emitidas antes siguen funcionando exactamente igual (también son reales); al regenerarlas salen como dc_live_.
Referencia de la API
URL base: https://api.datacred.org · Todas las respuestas siguen el formato: { success, data, error?, meta? }
Score pull (para socios)
/v1/partner/pullHace un pull del reporte de crédito de un usuario por un propósito legítimo. Registra una inquiry en los pulls HARD y descuenta una consulta de tu plan.
Pre-screen (para socios)
/v1/partner/prescreen/campaignsCrea una campaña de pre-screen para ofertas de marketing dirigidas.
Tradelines (para socios)
/v1/partner/tradelinesReporta un nuevo tradeline (endpoint de furnisher).
/v1/partner/tradelines/:idActualiza el saldo o el estado de un tradeline existente.
Uso y consumo (para socios)
/v1/partners/usageConsulta tu consumo de consultas del periodo. Es de solo lectura y no gasta una consulta, ideal para verificar que tu API key autentica.
Webhooks (para socios)
/v1/partners/webhooksLista los webhook endpoints de tu cuenta.
/v1/partners/webhooksRegistra un nuevo webhook endpoint.
/v1/partners/webhooks/:idRevoca un webhook endpoint.
Facturación (para socios)
/v1/partners/billing/balanceConsulta tu saldo de créditos disponible. De solo lectura, no gasta una consulta.
Acciones adversas (para socios)
/v1/partner/adverse-actionRegistra una notificación de acción adversa (obligatoria dentro de los 30 días de una negación).
Registros públicos e ítems negativos (para socios)
/v1/partner/public-recordsReporta un registro público (sentencia, quiebra, gravamen).
/v1/partner/negative-itemsReporta un ítem negativo (cobranza, charge-off).
Registro autoservicio (público, sin auth)
/v1/public/partner-signupRegistra una nueva empresa y su acceso al portal. No devuelve API keys: se crean en el portal cuando DataCred aprueba la empresa.
/v1/public/partner-signup/:id/verify-emailVerifica el correo de contacto del socio con el token enviado por email.
Modelos de score
Pasa scoreModelId en tu pull para elegir el modelo de scoring. Todos los modelos devuelven un score entre 300 y 850. El precio por consulta es el mismo para cualquier modelo, sin recargo.
| ID del modelo | Nombre | Caso de uso | Factores principales | Ventana de consultas | Precio |
|---|---|---|---|---|---|
datacred_consumer | DataCred Consumer | Score de historial de crédito para consumidores (UI, resumen general) | Historial de pagos (30%), utilización (20%), antigüedad (15%) | 365 días | Sin recargo por modelo |
datacred_risk_auto | DataCred Risk: Auto | Suscripción para crédito automotriz | Historial de pagos (40%), antigüedad (20%), utilización (10%) | 365 días | Sin recargo por modelo |
datacred_risk_mortgage | DataCred Risk: Hipotecario | Suscripción hipotecaria (ventana de consultas de 2 años) | Utilización (25%), registros públicos (15%), historial (30%) | 730 días | Sin recargo por modelo |
datacred_risk_bankcard | DataCred Risk: Tarjeta | Suscripción para tarjetas de crédito | Utilización (30%), mezcla de cuentas (15%), historial (25%) | 365 días | Sin recargo por modelo |
datacred_risk_personal | DataCred Risk: Préstamo Personal | Préstamos personales sin garantía colateral | Historial (28%), ítems negativos (15%), utilización (18%) | 365 días | Sin recargo por modelo |
Webhooks
Registra webhook endpoints para recibir eventos en tiempo real. Los payloads se firman con HMAC-SHA256. Verifica el header X-DataCred-Signature antes de procesarlos.
// Verificación de firma (Node.js)
const crypto = require("crypto");
function verifyWebhook(rawBody, signature, signingSecret) {
const expected = crypto
.createHmac("sha256", signingSecret)
.update(rawBody)
.digest("hex");
return crypto.timingSafeEqual(
Buffer.from(expected, "hex"),
Buffer.from(signature, "hex")
);
}| Evento | Cuándo se dispara |
|---|---|
score.updated | El score DataCred del usuario cambió tras un recálculo. |
consent.granted | El usuario otorgó consentimiento a un socio para acceder al buró. |
consent.revoked | El usuario revocó un consentimiento otorgado antes. |
inquiry.hard_pull | Se creó una inquiry de tipo hard pull en el archivo de un usuario. |
adverse_action.filed | Se registró una notificación de acción adversa para un usuario. |
tradeline.reported | Un socio furnisher reportó un nuevo tradeline. |
tradeline.updated | Se actualizó un tradeline existente. |
negative_item.added | Se agregó un ítem negativo al archivo de un usuario. |
dispute.opened | Un consumidor abrió una disputa de crédito. |
dispute.resolved | Se resolvió una disputa de crédito. |
Códigos de error
Todos los errores siguen el formato: { success: false, error: { code, message, requestId } }
| Código | HTTP | Significado |
|---|---|---|
INVALID_API_KEY | 401 | API key ausente, revocada o expirada. |
API_KEY_EXPIRED | 401 | La API key pasó su fecha de expiración. |
PARTNER_INACTIVE | 403 | La cuenta de socio está suspendida o pendiente de aprobación. |
DENIED_NO_CONSENT | 403 | No hay una base de consentimiento válida para este pull. |
USER_NOT_FOUND | 404 | El userId solicitado no existe en DataCred. |
QUOTA_EXCEEDED | 429 | Alcanzaste el límite de consultas de tu plan mensual. Escríbenos para ampliarlo. |
INSUFFICIENT_DATA | 422 | No hay datos suficientes para calcular un score de este usuario. |
VALIDATION_ERROR | 400 | Al body le faltan campos obligatorios o tiene valores inválidos. |
RATE_LIMIT_EXCEEDED | 429 | Demasiadas solicitudes. Espera y reintenta luego de los segundos indicados en Retry-After. |
Precios y límites
El precio por consulta baja según cuántas hagas al mes. Reportar clientes es gratis y solo se cobran las consultas de evaluación servidas con éxito; los negados o con error no consumen tu plan.
| Volumen mensual | Precio por consulta | |
|---|---|---|
| Cortesía al aprobar | 10 gratis | créditos de consulta |
| 1 a 50 / mes | $1.00 | por consulta |
| 51 a 200 / mes | $0.85 | por consulta |
| 201 a 1,000 / mes | $0.65 | por consulta |
| 1,001 o más / mes | $0.40 | por consulta |
Límite de velocidad: hasta 120 consultas por minuto. Si lo superas recibes un 429 con el header Retry-After.
Cada respuesta incluye los headers X-RateLimit-Limit, X-RateLimit-Remaining y Retry-After. ¿Volúmenes mayores? Escríbenos.
Llaves y cobros
- DataCred no tiene un entorno de pruebas: toda API key es real (dc_live_) y consulta y reporta datos reales de personas.
- Las keys se crean en el portal de socios cuando DataCred aprueba tu empresa.
- Al aprobarte te regalamos 10 créditos: cada uno paga una consulta de evaluación.
- Después, cada consulta de evaluación se suma a tu cuenta del mes y se factura a fin de mes. Registrar que otorgaste el crédito no se cobra otra vez.
- Aplica el límite de 120 consultas por minuto.
¿Listo para empezar? Registra tu empresa y la revisamos en 1 a 2 días hábiles.