Inicio rápido

La API REST de AveriguaYa te permite consultar RUC, DNI, placa y licencia mediante peticiones HTTP simples. Todas las respuestas son JSON. Base URL: https://api.averiguaya.pe/api

curl https://api.averiguaya.pe/api/ruc/20548112611 \
  -H "Authorization: Bearer sk_live_xxx"

Respuesta de ejemplo

{
  "success": true,
  "data": {
    "ruc": "20548112611",
    "nombre_o_razon_social": "TELEFONICA DEL PERU S.A.A.",
    "estado": "ACTIVO",
    "condicion": "HABIDO",
    "direccion_completa": "AV. AREQUIPA NRO. 1155, LIMA",
    "departamento": "LIMA",
    "provincia": "LIMA",
    "distrito": "LINCE",
    "ubigeo_sunat": "150114"
  },
  "plan": "pro",
  "consultas_restantes": 9423,
  "time": 0.021
}

Autenticación

Autentica cada petición con tu API key en el encabezado Authorization. Genera y revoca claves desde tu panel. Nunca expongas tu clave en el frontend.

Authorization: Bearer sk_live_9f2c...e41a

Devuelve razón social, estado, condición, tipo de contribuyente, dirección fiscal, actividad CIIU, representantes y teléfonos.

curl "https://api.averiguaya.pe/api/ruc/20548112611" \
  -H "Authorization: Bearer sk_live_xxx"

{
  "success": true,
  "data": {
    "ruc": "20548112611",
    "nombre_o_razon_social": "TELEFONICA DEL PERU S.A.A.",
    "estado": "ACTIVO",
    "condicion": "HABIDO",
    "direccion_completa": "AV. AREQUIPA NRO. 1155, LIMA",
    "departamento": "LIMA",
    "provincia": "LIMA",
    "distrito": "LINCE",
    "ubigeo_sunat": "150114"
  },
  "plan": "pro",
  "consultas_restantes": 9423,
  "time": 0.021
}

Consulta hasta 100 RUCs en una sola petición. Ideal para procesos por lotes.

curl -X POST "https://api.averiguaya.pe/api/ruc/batch" \
  -H "Authorization: Bearer sk_live_xxx" \
  -H "Content-Type: application/json" \
  -d '{"rucs":["20548112611","20100070970","99999999999"]}'

{
  "success": true,
  "total": 3,
  "encontrados": 2,
  "resultados": [
    {
      "encontrado": true,
      "ruc": "20548112611",
      "nombre_o_razon_social": "TELEFONICA DEL PERU S.A.A.",
      "estado": "ACTIVO"
    },
    {
      "encontrado": true,
      "ruc": "20100070970",
      "nombre_o_razon_social": "EMPRESA DEMO SAC",
      "estado": "ACTIVO"
    },
    {
      "encontrado": false,
      "ruc": "99999999999"
    }
  ],
  "plan": "pro",
  "consultas_restantes": 9418,
  "time": 0.045
}

Busca empresas por coincidencia parcial en la razón social, con paginación.

curl "https://api.averiguaya.pe/api/ruc/search?q=telefonica&page=1" \
  -H "Authorization: Bearer sk_live_xxx"

{
  "success": true,
  "query": "telefonica",
  "page": 1,
  "page_size": 20,
  "hay_siguiente_pagina": false,
  "resultados": [
    {
      "ruc": "20548112611",
      "nombre_o_razon_social": "TELEFONICA DEL PERU S.A.A.",
      "estado": "ACTIVO"
    },
    {
      "ruc": "20511556368",
      "nombre_o_razon_social": "TELEFONICA GESTION DE SERVICIOS COMPARTIDOS S.A.C.",
      "estado": "ACTIVO"
    }
  ],
  "plan": "pro",
  "consultas_restantes": 9417,
  "time": 0.032
}

Devuelve nombres, apellidos, fecha de nacimiento, sexo, estado civil y ubigeo del ciudadano.

curl "https://api.averiguaya.pe/api/dni/41785209" \
  -H "Authorization: Bearer sk_live_xxx"

{
  "success": true,
  "data": {
    "numero": "41785209",
    "nombre_completo": "MARÍA FERNANDA QUISPE ROJAS",
    "fecha_nacimiento": "22/07/1983",
    "sexo": "FEMENINO",
    "estado_civil": "CASADA",
    "departamento": "LIMA",
    "provincia": "LIMA",
    "distrito": "SAN ISIDRO"
  },
  "plan": "pro",
  "consultas_restantes": 9422,
  "time": 0.018
}

Devuelve marca, modelo, año, color, clase, motor, chasis, propietario, SOAT e historial.

curl "https://api.averiguaya.pe/api/placa/BCD-472" \
  -H "Authorization: Bearer sk_live_xxx"

{
  "success": true,
  "data": {
    "placa": "BCD-472",
    "marca": "TOYOTA",
    "modelo": "COROLLA",
    "anio": 2021,
    "color": "BLANCO",
    "clase": "AUTOMOVIL",
    "soat_vigente": true,
    "soat_vencimiento": "2025-03-14",
    "revision_tecnica_vigente": true
  },
  "plan": "pro",
  "consultas_restantes": 9421,
  "time": 0.026
}

Devuelve categoría, clase, fechas de emisión y vencimiento, estado y récord de puntos.

curl "https://api.averiguaya.pe/api/licencia/Q10834279" \
  -H "Authorization: Bearer sk_live_xxx"

{
  "success": true,
  "data": {
    "licencia": "Q10834279",
    "categoria": "A-I",
    "estado": "Vigente",
    "fecha_emision": "2019-05-10",
    "fecha_vencimiento": "2029-05-10",
    "puntos_acumulados": 100
  },
  "plan": "pro",
  "consultas_restantes": 9420,
  "time": 0.019
}

Códigos de error

Límites de uso

El límite de peticiones (rate limit) depende de tu plan. Al excederlo recibirás un código 429 con la cabecera Retry-After.