Install

npm install -g @carrerahaus/latinfo
latinfo login

latinfo login opens GitHub OAuth in your browser and stores your API key in ~/.latinfo/config.json. Takes 30 seconds.

CLI

latinfo pe sunat padron 20100047218              # Lookup by RUC
latinfo pe sunat padron --search "banco credito" # Search by name
latinfo pe osce sanctioned 20100047218           # OSCE sanctions
latinfo sources                                   # List all available sources

SDK

npm install @carrerahaus/latinfo

import { Latinfo } from '@carrerahaus/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

// 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 @carrerahaus/latinfo && latinfo login

API

Base URL: https://api.latinfo.dev

GET /pe/ruc/:ruc              → Lookup by RUC (11 digits, legal entities only)
GET /pe/search?q=...          → Search by company name
GET /pe/:institution/:dataset/:id → Source-specific lookup
POST /auth/rotate             → Rotate API key

curl -H "Authorization: Bearer YOUR_API_KEY" \
  https://api.latinfo.dev/pe/ruc/20100047218

Full API reference: latinfo.dev/docs

What you don't have to do

You don't download hundreds of MB from SUNAT, OSCE, or OECE. You don't parse Latin1 with escaped pipe delimiters. You don't write check digit algorithms. You don't build a search index that handles S.A.C. and E.I.R.L. You don't set up daily import pipelines. You don't manage servers.

We do all of that. Daily.

Pricing

Billed in credits: a single-institution lookup or search costs 1 credit; a KYB costs 1 per government institution it cross-references.

• Free: 1,000 credits/month — no credit card
• Pro: 50,000 credits/month — $29/month

Live plan limits + your current usage: run latinfo plan, or GET https://api.latinfo.dev/plans (the single source of truth — these numbers are read from there, not hardcoded).

Links

• Website: latinfo.dev
• Docs: latinfo.dev/docs
• Changelog: latinfo.dev/changelog
• Status: carrera.instatus.com
• Email: [email protected]