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 da fonte

Publicador
Superintendencia de Banca Seguros y AFP, Peru
Cobertura
Legal-entity cooperatives listed in the SBS national COOPAC register.
Significado do 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.
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

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

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

rucstringpathobrigatório

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

Example: 20508118750

Exemplo de requisição

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

ruc string obrigatório

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

nombre string obrigatório

Published entity name.

nro_registro string obrigatório

SBS national COOPAC registration number.

fecha_registro string obrigatório

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

nivel_modular string obrigatório

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

nivel_operaciones string obrigatório

Published authorized operations level.

direccion string obrigatório

Registered cooperative address.

referencia string obrigatório

Published location reference, if supplied.

region string obrigatório

Published Peruvian department name.

provincia string obrigatório

Published province name.

distrito string obrigatório

Published district name.

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

Exemplo ilustrativo do esquema. Não é uma resposta ao 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"
}

Procedência e limitações

A cobertura varia por país e fonte pública. Um campo ausente não comprova que o fato não exista. Os registros públicos podem ter atrasos ou erros; revise as evidências e a data da fonte antes de usar um resultado.