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
Endpoint
Sección titulada «Endpoint»POST https://faktura-test.cgallardo.me/v1/lookup/rucPOST https://faktura.cgallardo.me/v1/lookup/rucEjemplo
Sección titulada «Ejemplo»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"] }'use Illuminate\Support\Facades\Http;
$response = Http::withToken('sk_test_...') ->post('https://faktura-test.cgallardo.me/v1/lookup/ruc', ['rucs' => ['20131312955', '10467793549', '20600000005', '123']]);
$data = $response->json();const response = await fetch('https://faktura-test.cgallardo.me/v1/lookup/ruc', { method: 'POST', headers: { Authorization: 'Bearer sk_test_...', 'Content-Type': 'application/json', }, body: JSON.stringify({ rucs: ['20131312955', '10467793549', '20600000005', '123'] }),});const data = await response.json();Respuesta 200 OK
Sección titulada «Respuesta 200 OK»{ "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.
Errores
Sección titulada «Errores»| 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.