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.

Source contract

Publisher
Superintendencia de Banca Seguros y AFP, Peru
Coverage
Legal-entity cooperatives listed in the SBS national COOPAC register.
Record meaning
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.
Accepted pattern
^\d{11}$
Cardinality
one
License
Reuse permission has not been verified. Public access is not a reuse license.

Known limitations

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

Machine-readable source contract · Source documentation

Authentication required. REST requests use a Latinfo API key. The interactive console builds the authorization header and does not store the key.

Parameters

rucstringpathrequired

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

Example: 20508118750

Request example

curl https://api.latinfo.dev/pe/sbs/coopac/ruc/20508118750 \
  -H "Authorization: Bearer $LATINFO_API_KEY"

Responses

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

Response headers

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

Response fields

ruc string required

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

nombre string required

Published entity name.

nro_registro string required

SBS national COOPAC registration number.

fecha_registro string required

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

nivel_modular string required

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

nivel_operaciones string required

Published authorized operations level.

direccion string required

Registered cooperative address.

referencia string required

Published location reference, if supplied.

region string required

Published Peruvian department name.

provincia string required

Published province name.

distrito string required

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.
No response body documented.
401Missing or invalid API key. Authenticate before retrying.
No response body documented.
404No published record, or identifier outside the legal-entity scope. Not proof that the company does not exist.
No response body documented.
429Rate or credit limit exceeded. Inspect the response and rate-limit headers before retrying.
No response body documented.
503Source unavailable. Report unavailable, not an empty result.
No response body documented.
Example JSON

Illustrative schema example. This is not a live response.

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

Provenance and limitations

Coverage varies by country and public source. A missing field is not evidence that the underlying fact does not exist. Public registries may be delayed or contain source errors; inspect the returned evidence and source date before relying on a result.