latinfo
v0.12.2
Published
Tax registry & procurement API for Latin America. Query RUC, DNI, NIT, licitaciones from Peru & Colombia. Offline MPHF search, full OCDS data, updated daily.
Maintainers
Readme
Install
npm install -g latinfo
latinfo loginlatinfo login opens GitHub OAuth in your browser and stores your API key in ~/.latinfo/config.json. Takes 30 seconds.
CLI
latinfo ruc 20100047218 # Lookup by RUC
latinfo dni 12345678 # Lookup by DNI (converts to RUC automatically)
latinfo search "banco de credito" # Search by company name
latinfo ruc 20100047218 --json # JSON output (for scripts and AI agents)No login needed for demo data (~95 embedded records). Run latinfo login for 18M+ records.
SDK
npm install latinfoimport { Latinfo } from 'latinfo';
const client = new Latinfo('YOUR_API_KEY');
// Lookup by RUC
const company = await client.pe.ruc('20100047218');
console.log(company.razon_social); // BANCO DE CREDITO DEL PERU
// Lookup by DNI
const person = await client.pe.dni('12345678');
// Search by company name
const results = await client.pe.search('banco de credito');
// Rotate API key
const { api_key } = await client.rotate();Get your API key: npm install -g latinfo && latinfo login
API
Base URL: https://api.latinfo.dev
GET /pe/ruc/:ruc → Lookup by RUC (11 digits)
GET /pe/dni/:dni → Lookup by DNI (8 digits)
GET /pe/search?q=... → Search by company name
POST /auth/rotate → Rotate API keycurl -H "Authorization: Bearer YOUR_API_KEY" \
https://api.latinfo.dev/pe/ruc/20100047218Full API reference: latinfo.dev/docs
Response fields
| Field | Description | Example |
|-------|-------------|---------|
| ruc | RUC number (11 digits) | 20100047218 |
| razon_social | Business name | BANCO DE CREDITO DEL PERU |
| estado | Tax status | ACTIVO |
| condicion | Domicile condition | HABIDO |
| ubigeo | Location code (6 digits) | 150114 |
| tipo_via | Street type | JR. |
| nombre_via | Street name | CENTENARIO |
| codigo_zona | Zone code | URB. |
| tipo_zona | Zone name | BALCONCILLO |
| numero | Street number | 156 |
| interior | Interior / apt | - |
| lote | Lot | - |
| departamento | Dept (within building) | - |
| manzana | Block | - |
| kilometro | Kilometer marker | - |
What you don't have to do
You don't download 364MB from SUNAT. You don't parse Latin1 with escaped pipe delimiters. You don't write a check digit algorithm. You don't build a search index that handles S.A.C. and E.I.R.L. You don't set up a daily import pipeline. You don't manage servers.
We do all of that. Daily.
Pricing
- Free: 100,000 requests/day — no credit card
- Pro: 10M requests/month — $1/month
Countries
| Country | Data | Status | |---------|------|--------| | Peru | SUNAT padrón — RUC, DNI, company search | Active | | Brazil, Mexico, Colombia, Argentina, Chile | — | In development |
Links
- Website: latinfo.dev
- Docs: latinfo.dev/docs
- Changelog: latinfo.dev/changelog
- Status: carrera.instatus.com
- Email: [email protected]
