API Docs — Latinfo

Autenticación

Todas las rutas requieren una API key en el header Authorization. La página api.latinfo.dev/lookup es pública sin key.

Authorization: Bearer lat_xxxxxxxxxxxxxxxx

Obtén tu key gratis iniciando sesión en api.latinfo.dev/auth/github o desde el CLI:

npx latinfo login

Planes

Free

$0 /mes

1,000 créditos / mes
Todos los endpoints
Sin tarjeta de crédito

Pro

$29 /mes

50,000 créditos / mes
Todos los endpoints
Soporte por email

Errores

La API devuelve errores JSON con el campo error:

{ "error": "not_found" }
{ "error": "invalid_ruc" }
{ "error": "out_of_scope" }   // RUC 10* (personas naturales, no se sirven)
{ "error": "invalid_query" }  // query menor a 3 caracteres

HTTP	Significado
400	ID o parámetro inválido
401	API key ausente o inválida
404	Registro no encontrado
429	Rate limit excedido

Padrón SUNAT

SUNAT

18M+ empresas del Registro Único de Contribuyentes. Actualizado diariamente. Solo personas jurídicas (RUC 20*).

GET /pe/sunat/padron/ruc/{ruc}

Param	Tipo		Descripción
ruc	string	requerido	RUC de 11 dígitos (solo RUC 20*)

GET /pe/sunat/padron/ruc/20100047218

{
  "ruc": "20100047218",
  "razon_social": "BANCO DE CREDITO DEL PERU",
  "estado": "ACTIVO",
  "condicion": "HABIDO",
  "ubigeo": "150114",
  "nombre_via": "CENTENARIO",
  "numero": "156"
}

GET /pe/sunat/padron/search?q={query}

Param	Tipo		Descripción
q	string	requerido	Mínimo 3 caracteres. Devuelve hasta 20 resultados por relevancia TF-IDF.

GET /pe/sunat/padron/search?q=banco+de+credito

SUNAT Coactiva

SUNAT

Empresas con deudas tributarias en cobranza coactiva. ~7.8K registros activos.

GET /pe/sunat/coactiva/ruc/{ruc}

Devuelve datos de cobranza coactiva para el RUC. 404 si no tiene deudas registradas.

Búsqueda por nombre (Perú)

Búsqueda full-text cross-source con TF-IDF. Maneja abreviaciones LATAM (S.A.C., E.I.R.L., S.R.L.). Hasta 20 resultados rankeados.

GET /pe/search?q={query}

GET /pe/search?q=alicorp

KYB cross-source

Agrega SUNAT + OSCE sancionados + multas + penalidades + OEFA + SEACE licitaciones en una sola respuesta. El endpoint más completo.

GET /pe/ruc/{ruc}

GET /pe/ruc/20100047218

{
  "sunat": { /* Padrón SUNAT */ },
  "osce_sanctioned": null,
  "osce_fines": null,
  "oefa": null,
  "tenders": [/* últimas licitaciones SEACE */]
}

OSCE — Sancionados

OSCE

~9.2K empresas inhabilitadas para contratar con el Estado. Fuente: OSCE Tribunal de Contrataciones.

GET /pe/osce/sanctioned/ruc/{ruc}

404 si el RUC no está en la lista de sancionados activos.

GET /pe/osce/sanctioned/search?q={query}

OSCE — Multas

OSCE

~4.5K multas impuestas por OSCE a contratistas del Estado.

GET /pe/osce/fines/ruc/{ruc}

OSCE — Penalidades

OSCE

~12.8K penalidades contractuales registradas en OSCE.

GET /pe/osce/penalidades/ruc/{ruc}

OSCE — Entidades del Estado

OSCE

~3.3K entidades públicas registradas como compradoras en contrataciones del Estado.

GET /pe/osce/entidades/ruc/{ruc}

OSCE — RNP por RUC

OSCE

1.43M+ registros del Registro Nacional de Proveedores vinculados por RUC. Incluye capacidades, especialidades y vigencia.

GET /pe/osce/rnp/by-ruc/{ruc}

SEACE / OECE — Licitaciones

SEACE OECE

900K+ procesos de contratación pública desde 2013. Formato OCDS 1.1. Actualizado diariamente.

GET /pe/licitaciones

Param	Tipo		Descripción
q	string	opcional	Texto libre en título, descripción y comprador
category	string	opcional	`goods` · `services` · `works`
min_amount	number	opcional	Monto mínimo en PEN
max_amount	number	opcional	Monto máximo en PEN
buyer	string	opcional	Nombre entidad compradora (substring)
status	string	opcional	`CONVOCADO` · `CONTRATADO` · `DESIERTO` · `NULO`
limit	integer	opcional	Máximo resultados (default 20, max 100)

GET /pe/licitaciones?q=hospital&status=CONVOCADO&min_amount=500000

GET /pe/oece/tenders/ocid/{ocid}

GET /pe/oece/tenders/ocid/ocds-dgv273-seacev3-2024-28-148

OEFA — Sanciones Ambientales

OEFA

14K+ sanciones administrativas del Organismo de Evaluación y Fiscalización Ambiental.

GET /pe/oefa/sanctions/ruc/{ruc}

GET /pe/oefa/sanctions/search?q={query}

Colombia — RUES

RUES

6M+ empresas del Registro Único Empresarial y Social de Colombia. Lookup por NIT.

GET /co/rues/registry/nit/{nit}

GET /co/rues/registry/nit/890903938

{
  "nit": "890903938",
  "razon_social": "BANCOLOMBIA S.A.",
  "estado": "ACTIVA"
}

GET /co/rues/registry/search?q={query}

MCP Server

38 tools para Claude, Cursor y otros agentes AI. Se autentica con la misma API key. Guía completa en Integraciones.

Configuración rápida (CLI)

claude mcp add --transport http latinfo https://api.latinfo.dev/mcp

Configuración manual

{
  "mcpServers": {
    "latinfo": {
      "type": "http",
      "url": "https://api.latinfo.dev/mcp",
      "headers": {
        "Authorization": "Bearer lat_xxxxxxxxxx"
      }
    }
  }
}

El MCP server expone todos los endpoints como tools. Puedes pedirle a Claude "busca empresas sancionadas por OSCE con licitaciones en salud" y él orquesta las llamadas automáticamente.