Filipino
EspañolEnglishPortuguêsFilipino
Kumuha ng libreng api key
Peru · pe_sunat_coactiva_search
OpenAPI

Search sunat · coactiva

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

Search the published name 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 enforceable-debt list.
Kahulugan ng tala
A published debt observation grouped by legal-entity taxpayer.
Identifier
Lookup by ruc as a string, preserving leading zeros. Accepted syntax and normalization are defined by the contract below.
Tinatanggap na pattern
^\d{11}$
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

  • Amounts are rounded integer PEN values; no listed debt is not a tax-clearance certificate.

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/coactiva/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
[].name string

Published entity name.

[].estado string
Response schema
{
  "type": "array",
  "items": {
    "type": "object",
    "properties": {
      "id": {
        "type": "string"
      },
      "name": {
        "type": "string",
        "description": "Published entity name.",
        "x-latinfo-meaning": "text"
      },
      "estado": {
        "type": "string"
      }
    }
  }
}
400Invalid identifier or query. Correct the input before retrying.
Walang nakadokumentong response body.
401Missing or invalid API key. Authenticate before retrying.
Walang nakadokumentong response body.
404No published record, or identifier outside the legal-entity scope. Not proof that the company does not exist.
Walang nakadokumentong response body.
429Rate or credit limit exceeded. Inspect the response and rate-limit headers before retrying.
Walang nakadokumentong response body.
503Source unavailable. Report unavailable, not an empty result.
Walang nakadokumentong response body.
Halimbawang JSON

Halimbawa ng schema lamang. Hindi ito live na tugon.

[
  {
    "id": "string",
    "name": "string",
    "estado": "string"
  }
]

Pinagmulan at mga limitasyon

Nag-iiba ang saklaw ayon sa bansa at pampublikong source. Ang nawawalang field ay hindi patunay na wala ang katotohanan. Maaaring maantala o magkamali ang mga rehistro; suriin ang ebidensya at petsa bago gamitin ang resulta.

Esc