/issuer/lookups/namesBuscar por nombres, apellidos o razón social
Envía el nombre completo en name (5–100 caracteres), preferentemente apellidos y nombres. Consulta hasta diez fichas. results conserva las fichas disponibles y unavailable enumera coincidencias cuya ficha falló, para reintentar por RUC. hasMore indica que debes precisar la búsqueda. Caché de 15 minutos solo para respuestas completas; cinco consultas por minuto y workspace. No consume operaciones de emisión.
Send request
Use the documented inputs to call this endpoint directly.
Request body
application/jsonrequiredResponses
Correcto.
{
"hasMore": true,
"query": "string",
"queryType": "dni",
"results": [
{
"address": "string",
"condition": "string",
"department": "string",
"district": "string",
"documentNumber": "string",
"documentType": "RUC",
"legalName": "string",
"province": "string",
"publicFields": {},
"source": "SUNAT_RUC",
"status": "string",
"tradeName": "string",
"ubigeo": "string"
}
],
"source": "SUNAT_RUC",
"unavailable": [
{
"legalName": "string",
"location": "string",
"ruc": "string",
"status": "string"
}
]
}Se devuelven hasta diez fichas por consulta. Usa un nombre más específico.
Values: "dni" · "name"
Coincidencias cuya ficha no respondió; se pueden reintentar por RUC.
VALIDATION_ERROR: El cuerpo, los parámetros o una regla del comprobante no son válidos. fields indica el campo.
{
"error": {
"code": "string",
"fields": {},
"message": "string",
"requestId": "",
"retryable": true
}
}UNAUTHENTICATED: Falta la clave API o no es válida.
{
"error": {
"code": "string",
"fields": {},
"message": "string",
"requestId": "",
"retryable": true
}
}TRIAL_EXPIRED: La prueba gratuita venció.
{
"error": {
"code": "string",
"fields": {},
"message": "string",
"requestId": "",
"retryable": true
}
}WORKSPACE_SUSPENDED: El workspace está suspendido.
{
"error": {
"code": "string",
"fields": {},
"message": "string",
"requestId": "",
"retryable": true
}
}RATE_LIMITED: Se superó el límite de peticiones. Respeta el header Retry-After.
{
"error": {
"code": "string",
"fields": {},
"message": "string",
"requestId": "",
"retryable": true
}
}INTERNAL_ERROR: Error interno. Reintenta y comparte el requestId con soporte.
{
"error": {
"code": "string",
"fields": {},
"message": "string",
"requestId": "",
"retryable": true
}
}LOOKUP_UNAVAILABLE: La consulta de RUC o DNI no está disponible; reintenta o envía customer.name.
{
"error": {
"code": "string",
"fields": {},
"message": "string",
"requestId": "",
"retryable": true
}
}Powered by heyo
