Search sunat · padron

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

Search the published razon_social 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 beginning with 20 in the reduced taxpayer padron.
Significado do registro: A taxpayer registration and fiscal-address components.
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: 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

departamento is an apartment/unit component, not geography. Taxpayer status and fiscal-address condition are separate.

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/padron/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

[].razon_social string

Registered legal name.

[].estado string

Publisher status; interpret in the context of this dataset.

ACTIVO · BAJA DEFINITIVA · BAJA DE OFICIO · BAJA NO ACTIV. SISEV · BAJA PROVISIONAL · BAJA PROV. POR OFICI · BAJA MULT.INSCR. Y O · SUSPENSION TEMPORAL · ANUL.PROVI.-ACTO ILI · ANULACION - ACTO ILI · ANULACION - ERROR SU · INHABILITADO-VENT.UN · NUM. INTERNO IDENTIF · OTROS OBLIGADOS · PENDIENTE DE INI. DE

Significado dos valores

TAX_REGISTRATION

ACTIVO

Active: SUNAT reports the taxpayer registration as active.

BAJA DEFINITIVA

Definitively cancelled: SUNAT reports the taxpayer registration as definitively cancelled.

BAJA DE OFICIO

Cancelled by SUNAT: SUNAT reports that it cancelled the taxpayer registration on its own initiative.

BAJA NO ACTIV. SISEV

Cancelled for no activity in SISEV: SUNAT reports cancellation because no activity was recorded in the SISEV verification system.

BAJA PROVISIONAL

Provisionally cancelled: SUNAT reports the taxpayer registration as provisionally cancelled.

BAJA PROV. POR OFICI

Provisionally cancelled by SUNAT: SUNAT reports that it provisionally cancelled the taxpayer registration on its own initiative.

BAJA MULT.INSCR. Y O

Cancelled due to multiple registrations or another cause: SUNAT reports cancellation due to multiple registrations or another official cause.

SUSPENSION TEMPORAL

Temporarily suspended: SUNAT reports the taxpayer registration as temporarily suspended.

ANUL.PROVI.-ACTO ILI

Provisionally annulled for an unlawful act: SUNAT reports a provisional annulment associated with an unlawful act.

ANULACION - ACTO ILI

Annulled for an unlawful act: SUNAT reports annulment associated with an unlawful act.

ANULACION - ERROR SU

Annulled due to a SUNAT error: SUNAT reports that the taxpayer registration was annulled due to an authority error.

INHABILITADO-VENT.UN

Disabled in the single-window system: SUNAT reports the taxpayer as disabled in the single-window system.

NUM. INTERNO IDENTIF

Internal identification number: SUNAT classifies this record as an internal identification number; no active-state conclusion is made.

OTROS OBLIGADOS

Other obligated party: SUNAT classifies this record as another type of obligated party; no active-state conclusion is made.

PENDIENTE DE INI. DE

Pending start of activities: SUNAT reports that the taxpayer is pending the start of activities.

Esquema de resposta

{
  "type": "array",
  "items": {
    "type": "object",
    "properties": {
      "id": {
        "type": "string"
      },
      "razon_social": {
        "type": "string",
        "description": "Registered legal name.",
        "x-latinfo-meaning": "text"
      },
      "estado": {
        "type": "string",
        "description": "Publisher status; interpret in the context of this dataset.",
        "x-latinfo-meaning": "text",
        "enum": [
          "ACTIVO",
          "BAJA DEFINITIVA",
          "BAJA DE OFICIO",
          "BAJA NO ACTIV. SISEV",
          "BAJA PROVISIONAL",
          "BAJA PROV. POR OFICI",
          "BAJA MULT.INSCR. Y O",
          "SUSPENSION TEMPORAL",
          "ANUL.PROVI.-ACTO ILI",
          "ANULACION - ACTO ILI",
          "ANULACION - ERROR SU",
          "INHABILITADO-VENT.UN",
          "NUM. INTERNO IDENTIF",
          "OTROS OBLIGADOS",
          "PENDIENTE DE INI. DE"
        ],
        "x-latinfo-vocabulary": {
          "id": "pe.sunat.tax_status.v1",
          "scope": "TAX_REGISTRATION",
          "empty_policy": "reject",
          "values": {
            "ACTIVO": {
              "code": "ACTIVE",
              "label_en": "Active",
              "explanation_en": "SUNAT reports the taxpayer registration as active."
            },
            "BAJA DEFINITIVA": {
              "code": "CANCELLED",
              "label_en": "Definitively cancelled",
              "explanation_en": "SUNAT reports the taxpayer registration as definitively cancelled."
            },
            "BAJA DE OFICIO": {
              "code": "CANCELLED",
              "label_en": "Cancelled by SUNAT",
              "explanation_en": "SUNAT reports that it cancelled the taxpayer registration on its own initiative."
            },
            "BAJA NO ACTIV. SISEV": {
              "code": "CANCELLED",
              "label_en": "Cancelled for no activity in SISEV",
              "explanation_en": "SUNAT reports cancellation because no activity was recorded in the SISEV verification system."
            },
            "BAJA PROVISIONAL": {
              "code": "SUSPENDED",
              "label_en": "Provisionally cancelled",
              "explanation_en": "SUNAT reports the taxpayer registration as provisionally cancelled."
            },
            "BAJA PROV. POR OFICI": {
              "code": "SUSPENDED",
              "label_en": "Provisionally cancelled by SUNAT",
              "explanation_en": "SUNAT reports that it provisionally cancelled the taxpayer registration on its own initiative."
            },
            "BAJA MULT.INSCR. Y O": {
              "code": "CANCELLED",
              "label_en": "Cancelled due to multiple registrations or another cause",
              "explanation_en": "SUNAT reports cancellation due to multiple registrations or another official cause."
            },
            "SUSPENSION TEMPORAL": {
              "code": "SUSPENDED",
              "label_en": "Temporarily suspended",
              "explanation_en": "SUNAT reports the taxpayer registration as temporarily suspended."
            },
            "ANUL.PROVI.-ACTO ILI": {
              "code": "SUSPENDED",
              "label_en": "Provisionally annulled for an unlawful act",
              "explanation_en": "SUNAT reports a provisional annulment associated with an unlawful act."
            },
            "ANULACION - ACTO ILI": {
              "code": "CANCELLED",
              "label_en": "Annulled for an unlawful act",
              "explanation_en": "SUNAT reports annulment associated with an unlawful act."
            },
            "ANULACION - ERROR SU": {
              "code": "CANCELLED",
              "label_en": "Annulled due to a SUNAT error",
              "explanation_en": "SUNAT reports that the taxpayer registration was annulled due to an authority error."
            },
            "INHABILITADO-VENT.UN": {
              "code": "SUSPENDED",
              "label_en": "Disabled in the single-window system",
              "explanation_en": "SUNAT reports the taxpayer as disabled in the single-window system."
            },
            "NUM. INTERNO IDENTIF": {
              "code": "UNKNOWN",
              "label_en": "Internal identification number",
              "explanation_en": "SUNAT classifies this record as an internal identification number; no active-state conclusion is made."
            },
            "OTROS OBLIGADOS": {
              "code": "UNKNOWN",
              "label_en": "Other obligated party",
              "explanation_en": "SUNAT classifies this record as another type of obligated party; no active-state conclusion is made."
            },
            "PENDIENTE DE INI. DE": {
              "code": "PENDING",
              "label_en": "Pending start of activities",
              "explanation_en": "SUNAT reports that the taxpayer is pending the start of activities."
            }
          }
        }
      }
    }
  }
}

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