Ir al contenido

Consultar varios RUC a la vez

Hasta 1000 RUC por llamada; los repetidos se consultan una vez. Un RUC inválido no hace fallar la llamada: se informa en invalid.

Método: POST

POST https://faktura-test.cgallardo.me/v1/lookup/ruc
Ventana de terminal
curl -X POST https://faktura-test.cgallardo.me/v1/lookup/ruc \
-H "Authorization: Bearer sk_test_..." \
-H "Content-Type: application/json" \
-d '{ "rucs": ["20131312955", "10467793549", "20600000005", "123"] }'
{
"items": [
{ "ruc": "20131312955", "name": "EMPRESA DE PRUEBA S.A.C.", "status": "ACTIVO", "address_condition": "HABIDO", "is_active_and_found": true, "ubigeo": "150122", "address": "AV. LARCO NRO. 123" },
{ "ruc": "10467793549", "name": "PERSONA DE PRUEBA", "status": "ACTIVO", "address_condition": "HABIDO", "is_active_and_found": true, "ubigeo": "150101", "address": null }
],
"not_found": ["20600000005"],
"invalid": ["123"],
"as_of": "2026-11-13"
}

items no sigue el orden de la petición; relaciónalos por ruc.

Estado reason Causa
422 ValidationFailed rucs falta, está vacío o tiene más de 1000 elementos.
503 RucLookupUnavailable El servicio de consulta no está disponible temporalmente.

Usa el mismo padrón que Consultar un RUC, con los mismos campos.