Peru · pe_sbs_coopac_ruc
OpenAPI

Lookup sbs · coopac by RUC

GET https://api.latinfo.dev/pe/sbs/coopac/ruc/{ruc}

A cooperative registration with authorized modular and operations levels. Coverage: Legal-entity cooperatives listed in the SBS national COOPAC register. Lookup by ruc as a string, preserving leading zeros. Accepted syntax and normalization are defined by the contract below. Registration and authorized level are not a solvency assessment; modular thresholds are not actual asset amounts. Returns one record. Import time is not observation time; inspect freshness headers.

Kontrata ng source

Publisher
Superintendencia de Banca Seguros y AFP, Peru
Saklaw
Legal-entity cooperatives listed in the SBS national COOPAC register.
Kahulugan ng tala
A cooperative registration with authorized modular and operations levels.
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

  • Registration and authorized level are not a solvency assessment; modular thresholds are not actual asset amounts.

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: 20508118750

Halimbawa ng request

curl https://api.latinfo.dev/pe/sbs/coopac/ruc/20508118750 \
  -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.

nombre string kailangan

Published entity name.

nro_registro string kailangan

SBS national COOPAC registration number.

fecha_registro string kailangan

Published fecha registro date. Format: DD/MM/YYYY.

nivel_modular string kailangan

Published modular level and asset-range thresholds in UIT; this is not the cooperative asset amount.

nivel_operaciones string kailangan

Published authorized operations level.

direccion string kailangan

Registered cooperative address.

referencia string kailangan

Published location reference, if supplied.

region string kailangan

Published Peruvian department name.

provincia string kailangan

Published province name.

distrito string kailangan

Published district name.

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."
    },
    "nombre": {
      "type": "string",
      "description": "Published entity name.",
      "x-latinfo-meaning": "text"
    },
    "nro_registro": {
      "type": "string",
      "description": "SBS national COOPAC registration number.",
      "x-latinfo-meaning": "identifier"
    },
    "fecha_registro": {
      "type": "string",
      "description": "Published fecha registro date. Format: DD/MM/YYYY.",
      "x-latinfo-meaning": "date"
    },
    "nivel_modular": {
      "type": "string",
      "description": "Published modular level and asset-range thresholds in UIT; this is not the cooperative asset amount.",
      "x-latinfo-meaning": "text"
    },
    "nivel_operaciones": {
      "type": "string",
      "description": "Published authorized operations level.",
      "x-latinfo-meaning": "text"
    },
    "direccion": {
      "type": "string",
      "description": "Registered cooperative address.",
      "x-latinfo-meaning": "text"
    },
    "referencia": {
      "type": "string",
      "description": "Published location reference, if supplied.",
      "x-latinfo-meaning": "text"
    },
    "region": {
      "type": "string",
      "description": "Published Peruvian 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"
    }
  },
  "required": [
    "ruc",
    "nombre",
    "nro_registro",
    "fecha_registro",
    "nivel_modular",
    "nivel_operaciones",
    "direccion",
    "referencia",
    "region",
    "provincia",
    "distrito"
  ],
  "additionalProperties": false
}
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.

{
  "ruc": "string",
  "nombre": "string",
  "nro_registro": "string",
  "fecha_registro": "string",
  "nivel_modular": "string",
  "nivel_operaciones": "string",
  "direccion": "string",
  "referencia": "string",
  "region": "string",
  "provincia": "string",
  "distrito": "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.