/issuer/lookups/rucConsultar ficha pública por RUC
Devuelve datos tributarios normalizados y publicFields con todos los campos de texto de la ficha principal publicada por SUNAT, incluidas sus tablas. No incluye las consultas separadas de representantes, deuda, historial ni anexos. Cinco consultas por minuto y workspace; caché de 24 horas.
Send request
Use the documented inputs to call this endpoint directly.
Request body
application/jsonrequiredResponses
Correcto.
{
"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"
}Todos los campos de texto de la ficha pública, incluidas filas de tablas.
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
}
}CUSTOMER_NOT_FOUND: No se encontraron datos para el RUC o DNI del cliente; envía customer.name.
{
"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
