Search sunat · ciiu

GET https://api.latinfo.dev/pe/sunat/ciiu/search

Search the published ciiu_principal index. Results are candidates, not confirmed identity matches. Confirm the country and identifier before fetching a profile. An empty list is not proof of absence.

Contrato da fonte

Publicador: SUNAT, Peru
Cobertura: Legal-entity RUCs in the published economic-activity padron.
Significado do registro: A taxpayer activity profile with declared workforce and principal geography.
Identificador: Lookup by ruc as a string, preserving leading zeros. Accepted syntax and normalization are defined by the contract below.
Padrão aceito: ^20\d{9}$
Quantidade de registros: one
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

Principal activity is text with Rev. 4/Rev. 3 fallback; a classification join is required before treating it as a code.

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

qstringqueryobrigatório

Name query, 3–200 characters.

Exemplo de requisição

curl https://api.latinfo.dev/pe/sunat/ciiu/search?q=q \
  -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.

Content-Type: application/json

Campos da resposta

[].id string

[].ciiu_principal string

Principal economic-activity description, Rev. 4 with Rev. 3 fallback; not a numeric activity code.

[].estado string

Publisher status; interpret in the context of this dataset.

Esquema de resposta

{
  "type": "array",
  "items": {
    "type": "object",
    "properties": {
      "id": {
        "type": "string"
      },
      "ciiu_principal": {
        "type": "string",
        "description": "Principal economic-activity description, Rev. 4 with Rev. 3 fallback; not a numeric activity code.",
        "x-latinfo-meaning": "text"
      },
      "estado": {
        "type": "string",
        "description": "Publisher status; interpret in the context of this dataset.",
        "x-latinfo-meaning": "text"
      }
    }
  }
}

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