Lookup sunat · locales by RUC

GET https://api.latinfo.dev/pe/sunat/locales/ruc/{ruc}

One annex establishment address; a company can have several records. Coverage: Annex establishments published for legal-entity RUCs. Lookup by ruc as a string, preserving leading zeros. Accepted syntax and normalization are defined by the contract below. departamento is an address/unit component, not the geographic department; resolve UBIGEO for geography. Returns all records as an array. Import time is not observation time; inspect freshness headers. Add limit (1–500) and offset to retrieve an explicit page; without them the complete original array is returned. X-Total-Count gives the exact row count; follow Link rel=next to retrieve all pages.

Contrato da fonte

Publicador: SUNAT, Peru
Cobertura: Annex establishments published for legal-entity RUCs.
Significado do registro: One annex establishment address; a company can have several records.
Identificador: Lookup by ruc as a string, preserving leading zeros. Accepted syntax and normalization are defined by the contract below.
Padrão aceito: ^\d{11}$
Quantidade de registros: many
Licença: A permissão de reutilização não foi verificada. Acesso público não equivale a uma licença de reutilização.

Limitações conhecidas

departamento is an address/unit component, not the geographic department; resolve UBIGEO for geography.

Contrato da fonte para agentes · Documentação da fonte

Autenticação necessária. As requisições REST usam uma chave de api do Latinfo. O console adiciona o cabeçalho de autorização e não armazena a chave.

Parâmetros

rucstringpathobrigatório

RUC in the source's normalized format. Keep identifiers as strings; preserve leading zeros.

Example: 20100047218

limitintegerquery

Optional page size. Supplying limit or offset enables explicit pagination; default page size is 100.

offsetintegerquery

Row offset, default 0. Keep the same source generation while collecting pages.

generationstringquery

Opaque source-generation guard, automatically included in the next-page Link. A changed generation returns 409; restart retrieval.

Exemplo de requisição

curl https://api.latinfo.dev/pe/sunat/locales/ruc/20100047218 \
  -H "Authorization: Bearer $LATINFO_API_KEY"

Respostas

200Published source records. Missing data is not a clearance or a negative finding.

Cabeçalhos da resposta

X-Latinfo-Imported-At

Import time, not the date of the government observation.

X-Source-Updated-At

Publisher update time, when known.

X-Latest-Observation-At

Latest date in returned records, when known.

X-Freshness-Status

string

CURRENT · DELAYED · STALE · UNKNOWN

X-Credits-Cost

Actual credits charged for this request.

X-Source-Generation

Opaque immutable source generation. Follow the guarded next-page Link when collecting a history.

X-Total-Count

Exact row count for this identifier when pagination is requested.

X-Page-Offset

integer

X-Page-Limit

integer

Link

Next page URL, rel=next. Absent at the end.

Content-Type: application/json

Campos da resposta

[].ruc string obrigatório

Lookup by ruc as a string, preserving leading zeros. Accepted syntax and normalization are defined by the contract below.

[].ubigeo string obrigatório

Six-digit INEI district code; retain leading zeros.

[].tipo_via string obrigatório

Published street-type abbreviation.

[].nombre_via string obrigatório

Published street name.

[].codigo_zona string obrigatório

Published zone-type abbreviation.

[].tipo_zona string obrigatório

Published zone name.

[].numero string obrigatório

External street number; not a count.

[].kilometro string obrigatório

Address kilometer marker; not a measured company distance.

[].interior string obrigatório

Interior/unit address component.

[].lote string obrigatório

Address lot component.

[].departamento string obrigatório

Apartment/unit address component; not the geographic department.

[].manzana string obrigatório

Address block component.

Esquema de resposta

{
  "type": "array",
  "items": {
    "type": "object",
    "properties": {
      "ruc": {
        "type": "string",
        "description": "Lookup by ruc as a string, preserving leading zeros. Accepted syntax and normalization are defined by the contract below."
      },
      "ubigeo": {
        "type": "string",
        "description": "Six-digit INEI district code; retain leading zeros.",
        "x-latinfo-meaning": "code"
      },
      "tipo_via": {
        "type": "string",
        "description": "Published street-type abbreviation.",
        "x-latinfo-meaning": "text"
      },
      "nombre_via": {
        "type": "string",
        "description": "Published street name.",
        "x-latinfo-meaning": "text"
      },
      "codigo_zona": {
        "type": "string",
        "description": "Published zone-type abbreviation.",
        "x-latinfo-meaning": "text"
      },
      "tipo_zona": {
        "type": "string",
        "description": "Published zone name.",
        "x-latinfo-meaning": "text"
      },
      "numero": {
        "type": "string",
        "description": "External street number; not a count.",
        "x-latinfo-meaning": "text"
      },
      "kilometro": {
        "type": "string",
        "description": "Address kilometer marker; not a measured company distance.",
        "x-latinfo-meaning": "text"
      },
      "interior": {
        "type": "string",
        "description": "Interior/unit address component.",
        "x-latinfo-meaning": "text"
      },
      "lote": {
        "type": "string",
        "description": "Address lot component.",
        "x-latinfo-meaning": "text"
      },
      "departamento": {
        "type": "string",
        "description": "Apartment/unit address component; not the geographic department.",
        "x-latinfo-meaning": "text"
      },
      "manzana": {
        "type": "string",
        "description": "Address block component.",
        "x-latinfo-meaning": "text"
      }
    },
    "required": [
      "ruc",
      "ubigeo",
      "tipo_via",
      "nombre_via",
      "codigo_zona",
      "tipo_zona",
      "numero",
      "kilometro",
      "interior",
      "lote",
      "departamento",
      "manzana"
    ],
    "additionalProperties": false
  }
}

400Invalid identifier or query. Correct the input before retrying.