Documentación

Autenticación

Cada petición necesita tu clave de acceso. Puedes enviarla como token Bearer o en la cabecera X-Api-Key.

Authorization: Bearer bk_live_tu_clave
Content-Type: application/json

Genera y revoca tus claves desde el panel. Puedes restringir cada clave a unas IP concretas y a un subconjunto de servicios.

Formato de respuesta

Toda respuesta correcta tiene la misma estructura:

{
  "ok": true,
  "servicio": "personas/dni",
  "datos": { ... },
  "meta": {
    "referencia": "ab_01k5m2...",
    "fecha": "2026-09-17T10:00:00-05:00",
    "creditos": 1
  }
}

referencia identifica la petición. Si necesitas soporte, envíanosla: con ella localizamos exactamente lo que ocurrió.

Errores

Los errores mantienen la misma forma, con un código estable que puedes tratar en tu código:

{
  "ok": false,
  "error": {
    "codigo": "no_encontrado",
    "mensaje": "No hay registros que coincidan con la consulta.",
    "reintentable": false
  }
}

Código	HTTP	Significado
`parametros_invalidos`	422	Los datos enviados no cumplen el formato esperado.
`no_encontrado`	404	No hay registros que coincidan con la consulta.
`no_autenticado`	401	Falta la clave de acceso en la cabecera de la petición.
`llave_invalida`	401	La clave de acceso no es válida.
`llave_inactiva`	403	La clave de acceso está desactivada.
`origen_no_autorizado`	403	El origen de la petición no está autorizado para esta clave.
`sin_creditos`	402	Tu saldo de consultas se ha agotado.
`limite_excedido`	429	Has superado el número de peticiones permitidas por minuto.
`servicio_no_disponible`	503	El servicio no está disponible temporalmente. Vuelve a intentarlo en unos segundos.
`recurso_no_existe`	404	La ruta solicitada no existe en esta API.
`metodo_no_permitido`	405	El método HTTP no está permitido para esta ruta.
`error_interno`	500	No pudimos completar la consulta. Inténtalo nuevamente.

Créditos y límites

· Cada servicio consume los créditos indicados en su ficha.
· Las consultas servidas desde caché no consumen créditos.
· Si la consulta falla por un problema del servicio, no se te cobra.
· Si la fuente responde sin contenido, tampoco se te cobra.
· Una consulta sin resultados sí consume crédito: la búsqueda se realizó.
· El límite de peticiones por minuto depende de tu plan.
· Consulta tu saldo con GET /api/v1/cuenta.

POST personas/dni 1 crédito

Petición

curl -X POST https://api.grupoveltrix.com/api/v1/personas/dni \
  -H "Authorization: Bearer bk_live_tu_clave" \
  -H "Content-Type: application/json" \
  -d '{"numero":"44556677"}'

Parámetros

numero

Campos de la respuesta

documento tipo_documento nombre_completo nombres apellidos.paterno apellidos.materno digito_verificador

POST personas/ruc-asociado 1 crédito

Petición

curl -X POST https://api.grupoveltrix.com/api/v1/personas/ruc-asociado \
  -H "Authorization: Bearer bk_live_tu_clave" \
  -H "Content-Type: application/json" \
  -d '{"numero":"44556677"}'

Parámetros

numero

Campos de la respuesta

ruc

POST empresas/ruc 1 crédito

Petición

curl -X POST https://api.grupoveltrix.com/api/v1/empresas/ruc \
  -H "Authorization: Bearer bk_live_tu_clave" \
  -H "Content-Type: application/json" \
  -d '{"ruc":"20131312955"}'

Parámetros

ruc

Campos de la respuesta

ruc razon_social estado condicion direccion departamento agente_retencion buen_contribuyente

POST empresas/ruc/ficha 2 créditos

Petición

curl -X POST https://api.grupoveltrix.com/api/v1/empresas/ruc/ficha \
  -H "Authorization: Bearer bk_live_tu_clave" \
  -H "Content-Type: application/json" \
  -d '{"ruc":"20131312955"}'

Parámetros

ruc

Campos de la respuesta

ruc razon_social estado condicion direccion tipo inscripcion actividades

POST empresas/ruc/contacto 2 créditos

Petición

curl -X POST https://api.grupoveltrix.com/api/v1/empresas/ruc/contacto \
  -H "Authorization: Bearer bk_live_tu_clave" \
  -H "Content-Type: application/json" \
  -d '{"ruc":"20131312955"}'

Parámetros

ruc

Campos de la respuesta

telefonos correos

POST empresas/ruc/domicilio 2 créditos

Petición

curl -X POST https://api.grupoveltrix.com/api/v1/empresas/ruc/domicilio \
  -H "Authorization: Bearer bk_live_tu_clave" \
  -H "Content-Type: application/json" \
  -d '{"ruc":"20131312955"}'

Parámetros

ruc

Campos de la respuesta

codigo tipo actividad direccion departamento provincia distrito ubigeo

POST empresas/ruc/anexos 2 créditos

Petición

curl -X POST https://api.grupoveltrix.com/api/v1/empresas/ruc/anexos \
  -H "Authorization: Bearer bk_live_tu_clave" \
  -H "Content-Type: application/json" \
  -d '{"ruc":"20131312955"}'

Parámetros

ruc

Campos de la respuesta

codigo tipo actividad direccion departamento provincia distrito ubigeo

POST empresas/ruc/representantes 2 créditos

Petición

curl -X POST https://api.grupoveltrix.com/api/v1/empresas/ruc/representantes \
  -H "Authorization: Bearer bk_live_tu_clave" \
  -H "Content-Type: application/json" \
  -d '{"ruc":"20131312955"}'

Parámetros

ruc

Campos de la respuesta

documento.tipo documento.numero nombre cargo desde

POST empresas/ruc/trabajadores 2 créditos

Petición

curl -X POST https://api.grupoveltrix.com/api/v1/empresas/ruc/trabajadores \
  -H "Authorization: Bearer bk_live_tu_clave" \
  -H "Content-Type: application/json" \
  -d '{"ruc":"20131312955"}'

Parámetros

ruc

Campos de la respuesta

periodo trabajadores pensionistas prestadores

POST empresas/ruc/deuda-coactiva 2 créditos

Petición

curl -X POST https://api.grupoveltrix.com/api/v1/empresas/ruc/deuda-coactiva \
  -H "Authorization: Bearer bk_live_tu_clave" \
  -H "Content-Type: application/json" \
  -d '{"ruc":"20131312955"}'

Parámetros

ruc

Campos de la respuesta

monto periodo inicio_cobranza entidad

POST empresas/ruc/sin-capacidad-operativa 2 créditos

Petición

curl -X POST https://api.grupoveltrix.com/api/v1/empresas/ruc/sin-capacidad-operativa \
  -H "Authorization: Bearer bk_live_tu_clave" \
  -H "Content-Type: application/json" \
  -d '{"ruc":"20131312955"}'

Parámetros

ruc

Campos de la respuesta

ruc razon_social direccion resolucion emision firmeza publicacion representante.documento representante.nombre

POST comprobantes/validar 1 crédito

Petición

curl -X POST https://api.grupoveltrix.com/api/v1/comprobantes/validar \
  -H "Authorization: Bearer bk_live_tu_clave" \
  -H "Content-Type: application/json" \
  -d '{"emisor_ruc":"20601234567","tipo_comprobante":"01","serie":"F001","numero":"123","fecha_emision":"2026-07-10","importe_total":118}'

Parámetros

emisor_ruc tipo_comprobante serie numero fecha_emision importe_total

Campos de la respuesta

emisor.ruc emisor.estado emisor.condicion serie numero estado_codigo estado observaciones

POST comprobantes/validar-lote 1 crédito

Petición

curl -X POST https://api.grupoveltrix.com/api/v1/comprobantes/validar-lote \
  -H "Authorization: Bearer bk_live_tu_clave" \
  -H "Content-Type: application/json" \
  -d '{"comprobantes":[]}'

Parámetros

comprobantes comprobantes.*

Campos de la respuesta

total comprobantes

POST finanzas/tipo-de-cambio 1 crédito

Petición

curl -X POST https://api.grupoveltrix.com/api/v1/finanzas/tipo-de-cambio \
  -H "Authorization: Bearer bk_live_tu_clave" \
  -H "Content-Type: application/json" \
  -d '{"fecha":"2026-07-24","moneda":"USD"}'

Parámetros

fecha moneda

Campos de la respuesta

moneda fecha fecha_publicacion compra venta

POST finanzas/comisiones-afp 1 crédito

Petición

curl -X POST https://api.grupoveltrix.com/api/v1/finanzas/comisiones-afp \
  -H "Authorization: Bearer bk_live_tu_clave" \
  -H "Content-Type: application/json" \
  -d '{"periodo":"2026-08"}'

Parámetros

periodo

Campos de la respuesta

periodo afp comision.fija comision.flujo comision.mixta_flujo comision.mixta_saldo prima_seguro aporte_obligatorio remuneracion_maxima

GET catalogos/ubigeos sin coste

Petición

curl https://api.grupoveltrix.com/api/v1/catalogos/ubigeos \
  -H "Authorization: Bearer bk_live_tu_clave"

Campos de la respuesta

codigo nombre provincias

GET catalogos/puertos sin coste

Petición

curl https://api.grupoveltrix.com/api/v1/catalogos/puertos \
  -H "Authorization: Bearer bk_live_tu_clave"

Campos de la respuesta

codigo nombre ubigeo departamento provincia distrito

GET catalogos/aeropuertos sin coste

Petición

curl https://api.grupoveltrix.com/api/v1/catalogos/aeropuertos \
  -H "Authorization: Bearer bk_live_tu_clave"

Campos de la respuesta

codigo nombre ubigeo departamento provincia distrito tipo

Autenticación

Formato de respuesta

Errores

Créditos y límites

Servicios