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.

Kontrata ng source

Publisher: SUNAT, Peru
Saklaw: Legal-entity RUCs in the published economic-activity padron.
Kahulugan ng tala: A taxpayer activity profile with declared workforce and principal geography.
Identifier: Lookup by ruc as a string, preserving leading zeros. Accepted syntax and normalization are defined by the contract below.
Tinatanggap na pattern: ^20\d{9}$
Bilang ng mga tala: one
Lisensya: Hindi pa nabeberipika ang pahintulot sa muling paggamit. Hindi lisensya sa muling paggamit ang pampublikong access.

Mga kilalang limitasyon

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

Kontrata ng source para sa mga agent · Dokumentasyon ng source

Kailangan ng authentication. Gumagamit ang REST request ng Latinfo api key. Idinaragdag ng console ang authorization header at hindi iniimbak ang key.

Mga parameter

qstringquerykailangan

Name query, 3–200 characters.

Halimbawa ng request

curl https://api.latinfo.dev/pe/sunat/ciiu/search?q=q \
  -H "Authorization: Bearer $LATINFO_API_KEY"

Mga tugon

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

Mga header ng tugon

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

Mga field ng tugon

[].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.

Response schema

{
  "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.