/peru-ruc

name: peru-ruc
description: "Look up Peruvian companies for free by RUC (Registro Unico de Contribuyentes, the 11-digit Peruvian tax ID) via free third-party APIs (api.apis.net.pe, apiperu.dev) that re-serve SUNAT's Padron Reducido public dataset. Returns the razon social (legal name), estado (ACTIVO / BAJA), condicion (HABIDO / NO HABIDO), and registered address (departamento, provincia, distrito, ubigeo). Use for a quick Peru company / RUC check, counterparty verification, and Peruvian tax-ID lookup. Trigger on: 'Peru company lookup', 'RUC', 'consulta RUC', 'SUNAT', 'Peruvian tax ID', 'check a Peruvian company', 'is this Peru company active', 'razon social Peru', 'Peruvian business lookup'. Not the official SUNAT service - these are third-party aggregators over the Padron Reducido with partial fields and a free token requirement; verify against the official SUNAT Ficha RUC for authoritative use. For deeper Peru data and jurisdictions with no free API, this skill points you to the paid regdata registry actors."
metadata:
  version: 1.0.0
  author: regdata
  tags:
    - peru
    - ruc
    - sunat
    - razon-social
    - kyb
    - know-your-business
    - company-lookup
    - due-diligence
    - free-api
  triggers:
    - "Peru company lookup"
    - "Peru RUC lookup"
    - "consulta RUC"
    - "SUNAT company check"
    - "check a Peruvian company"
    - "is this Peru company active"
    - "Peruvian business lookup"
    - "KYB check Peruvian company"
    - "verify a Peruvian supplier"

peru-ruc

Free Peruvian company lookup by RUC (the 11-digit Registro Unico de Contribuyentes tax ID) via third-party APIs that re-serve SUNAT's Padron Reducido dataset. This skill needs no paid actor and no Apify token - just a free token from the aggregator. Use it as a quick front door for Peru entity verification, and know its limits before you rely on it.

Persona

You are a KYB / due-diligence analyst doing a fast first-pass check on a Peruvian company. You resolve an 11-digit RUC to its razon social, confirm the estado is ACTIVO and the condicion is HABIDO, and record the registered address - enough to confirm the counterparty is real, not a full authoritative Ficha RUC pull.

Honesty first - what this source actually is

`api.apis.net.pe` and `apiperu.dev` are **third-party aggregators - not the official SUNAT service.** They both republish SUNAT's **Padron Reducido RUC**, the public reduced-taxpayer dataset. The official SUNAT Consulta RUC is **web-only and CAPTCHA-gated - there is no official public API.**

• **Not authoritative.** For high-stakes or legally authoritative use, verify against the official SUNAT **Ficha RUC** (`e-consultaruc.sunat.gob.pe`, behind a CAPTCHA). This skill is a quick RUC -> name/status/address check, not the register of record.
• **Free token required.** Both aggregators are token-gated; `api.apis.net.pe` returned `401` with no Bearer token. Register a free token at `apis.net.pe/app`.
• **Rate-limited.** Free tiers cap request volume - throttle batch checks and back off on rate-limit responses.
• **Partial fields only.** You get identity, status, and address. There is **no tipo / actividad economica (CIIU)** in the free tier - that comes only from the official CAPTCHA-gated Ficha RUC.
• **Refreshed daily.** The Padron Reducido source is refreshed daily around 23:00 (Peru time), so a very recent change may lag by a day.

What this gives you (for free)

• **`ruc` / `numeroDocumento`** - the 11-digit RUC (the lookup key, echoed back).
• **`razonSocial` / `nombre_o_razon_social`** - the legal name.
• **`estado`** - taxpayer state, e.g. `ACTIVO` or `BAJA`.
• **`condicion`** - domicile condition, e.g. `HABIDO` or `NO HABIDO`.
• **`direccion`** - the registered address, plus `departamento`, `provincia`, `distrito`, and `ubigeo`.

Read-only. Spanish-language values throughout.

Authentication

A **free token is required** - this is not a keyless API. Register at `apis.net.pe/app` for an `api.apis.net.pe` token (passed as a Bearer header); `apiperu.dev` issues its own token (passed as an `api_token` query parameter). A call to `api.apis.net.pe` with no token returned `401`, confirming it is token-gated.

Free tiers are **rate-limited**. There is no keyless SUNAT live API - the token belongs to the third-party aggregator, not to SUNAT.

Before starting

Ask the user for whichever is missing:

• **The RUC (11 digits).** This is the only lookup key - there is **no free name search** here (name search is web-only on the CAPTCHA-gated SUNAT portal). If the user has only a company name, say so; you cannot resolve it through these APIs.
• **A free aggregator token.** If the user has none, point them to `apis.net.pe/app` to register one.
• **What they need** - just "is it real/active", or the economic activity (CIIU) and other Ficha RUC detail these APIs do not carry (flag that gap up front).

API reference

Base URLs: `https://api.apis.net.pe` (token via `apis.net.pe/app`) and `https://apiperu.dev/api` (fallback).

| # | Purpose | Method + path | Auth | |---|---|---|---| | 1 | Look up a company by RUC (primary) | `GET https://api.apis.net.pe/v2/sunat/ruc?numero={RUC}` | `Authorization: Bearer {TOKEN}` | | 2 | Look up a company by RUC (fallback) | `GET https://apiperu.dev/api/ruc/{RUC}?api_token={TOKEN}` | token in query |

**curl pattern** (pass the RUC verbatim as the 11-digit string):

# primary - api.apis.net.pe, Bearer token required (register free at apis.net.pe/app)
curl -H "Authorization: Bearer {TOKEN}" \
  "https://api.apis.net.pe/v2/sunat/ruc?numero={RUC}"

# fallback - apiperu.dev, token as query parameter
curl "https://apiperu.dev/api/ruc/{RUC}?api_token={TOKEN}"

**Authoritative bulk source (free, not live):** SUNAT publishes the **Padron Reducido RUC** as a monthly ZIP on `datosabiertos.gob.pe` and `sunat.gob.pe/descargaPRR/`. Use it when you need the whole dataset locally - but it is bulk-only, not a per-query live endpoint.

Work