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.

Contrato de la fuente

Publicador
Superintendencia de Banca Seguros y AFP, Peru
Cobertura
Legal-entity cooperatives listed in the SBS national COOPAC register.
Qué representa un registro
A cooperative registration with authorized modular and operations levels.
Identificador
Lookup by ruc as a string, preserving leading zeros. Accepted syntax and normalization are defined by the contract below.
Patrón admitido
^\d{11}$
Cantidad de registros
one
Licencia
No se ha verificado el permiso de reutilización. El acceso público no equivale a una licencia de reutilización.

Limitaciones conocidas

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

Contrato de la fuente para agentes · Documentación de la fuente

Requiere autenticación. Las solicitudes REST usan una clave de api de Latinfo. La consola agrega el encabezado de autorización y no guarda la clave.

Parámetros

rucstringpathobligatorio

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

Example: 20508118750

Ejemplo de solicitud

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

Respuestas

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

Encabezados de la respuesta

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 de la respuesta

ruc string obligatorio

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

nombre string obligatorio

Published entity name.

nro_registro string obligatorio

SBS national COOPAC registration number.

fecha_registro string obligatorio

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

nivel_modular string obligatorio

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

nivel_operaciones string obligatorio

Published authorized operations level.

direccion string obligatorio

Registered cooperative address.

referencia string obligatorio

Published location reference, if supplied.

region string obligatorio

Published Peruvian department name.

provincia string obligatorio

Published province name.

distrito string obligatorio

Published district name.

Esquema de respuesta
{
  "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 se documentó un cuerpo de respuesta.
401Missing or invalid API key. Authenticate before retrying.
No se documentó un cuerpo de respuesta.
404No published record, or identifier outside the legal-entity scope. Not proof that the company does not exist.
No se documentó un cuerpo de respuesta.
429Rate or credit limit exceeded. Inspect the response and rate-limit headers before retrying.
No se documentó un cuerpo de respuesta.
503Source unavailable. Report unavailable, not an empty result.
No se documentó un cuerpo de respuesta.
Ejemplo JSON

Ejemplo ilustrativo del esquema. No es una respuesta en vivo.

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

Procedencia y limitaciones

La cobertura varía por país y fuente pública. Un campo ausente no demuestra que el hecho no exista. Los registros públicos pueden tener retrasos o errores; revisa la evidencia y la fecha de la fuente antes de usar un resultado.