Lookup sunat · ciiu by RUC

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

A taxpayer activity profile with declared workforce and principal geography. Coverage: Legal-entity RUCs in the published economic-activity padron. Lookup by ruc as a string, preserving leading zeros. Accepted syntax and normalization are defined by the contract below. Principal activity is text with Rev. 4/Rev. 3 fallback; a classification join is required before treating it as a code. Returns one record. Import time is not observation time; inspect freshness headers.

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

rucstringpathkailangan

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

Example: 20100017491

Halimbawa ng request

curl https://api.latinfo.dev/pe/sunat/ciiu/ruc/20100017491 \
  -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

ruc string kailangan

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

tipo_contribuyente string kailangan

Published taxpayer-type label; not reliable by itself for legal/natural-person classification.

ciiu_principal string kailangan

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

ciiu_r3_principal string kailangan

Original Rev. 3 principal economic-activity description.

ciiu_secundaria string kailangan

Original Rev. 3 secondary economic-activity description.

nro_trabajadores string kailangan

Declared workforce count, not independently verified. Unit: people.

people

comercio_exterior string kailangan

Published import/export activity designation.

sistema_contabilidad string kailangan

Published accounting system: manual, computerized or both.

estado string kailangan

Publisher status; interpret in the context of this dataset.

condicion string kailangan

Published fiscal-address condition; distinct from taxpayer status.

departamento string kailangan

Published department name.

provincia string kailangan

Published province name.

distrito string kailangan

Published district name.

ubigeo string kailangan

Six-digit INEI district code; retain leading zeros.

Response schema

{
  "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."
    },
    "tipo_contribuyente": {
      "type": "string",
      "description": "Published taxpayer-type label; not reliable by itself for legal/natural-person classification.",
      "x-latinfo-meaning": "text"
    },
    "ciiu_principal": {
      "type": "string",
      "description": "Principal economic-activity description, Rev. 4 with Rev. 3 fallback; not a numeric activity code.",
      "x-latinfo-meaning": "text"
    },
    "ciiu_r3_principal": {
      "type": "string",
      "description": "Original Rev. 3 principal economic-activity description.",
      "x-latinfo-meaning": "text"
    },
    "ciiu_secundaria": {
      "type": "string",
      "description": "Original Rev. 3 secondary economic-activity description.",
      "x-latinfo-meaning": "text"
    },
    "nro_trabajadores": {
      "type": "string",
      "description": "Declared workforce count, not independently verified. Unit: people.",
      "x-latinfo-meaning": "quantity",
      "x-latinfo-unit": "people"
    },
    "comercio_exterior": {
      "type": "string",
      "description": "Published import/export activity designation.",
      "x-latinfo-meaning": "text"
    },
    "sistema_contabilidad": {
      "type": "string",
      "description": "Published accounting system: manual, computerized or both.",
      "x-latinfo-meaning": "text"
    },
    "estado": {
      "type": "string",
      "description": "Publisher status; interpret in the context of this dataset.",
      "x-latinfo-meaning": "text"
    },
    "condicion": {
      "type": "string",
      "description": "Published fiscal-address condition; distinct from taxpayer status.",
      "x-latinfo-meaning": "text"
    },
    "departamento": {
      "type": "string",
      "description": "Published department name.",
      "x-latinfo-meaning": "text"
    },
    "provincia": {
      "type": "string",
      "description": "Published province name.",
      "x-latinfo-meaning": "text"
    },
    "distrito": {
      "type": "string",
      "description": "Published district name.",
      "x-latinfo-meaning": "text"
    },
    "ubigeo": {
      "type": "string",
      "description": "Six-digit INEI district code; retain leading zeros.",
      "x-latinfo-meaning": "code"
    }
  },
  "required": [
    "ruc",
    "tipo_contribuyente",
    "ciiu_principal",
    "ciiu_r3_principal",
    "ciiu_secundaria",
    "nro_trabajadores",
    "comercio_exterior",
    "sistema_contabilidad",
    "estado",
    "condicion",
    "departamento",
    "provincia",
    "distrito",
    "ubigeo"
  ],
  "additionalProperties": false
}

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