Português
EspañolEnglishPortuguêsFilipino
Criar chave grátis
Peru · pe_osce_cod_cuadernos_search
OpenAPI

Search osce · cod-cuadernos

GET https://api.latinfo.dev/pe/osce/cod-cuadernos/search

Search the published razon_social_contratista 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.

Contrato da fonte

Publicador
OSCE / OECE, Peru
Cobertura
Published construction notebooks associated with legal-entity contractors/consortium members.
Significado do registro
A works notebook and contractor membership record.
Identificador
Lookup by ruc_contratista as a string, preserving leading zeros. Accepted syntax and normalization are defined by the contract below.
Padrão aceito
^\d{11}$
Quantidade de registros
many
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

  • Repeated rows can describe consortium membership; they are not independent contracts.

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

qstringqueryobrigatório

Name query, 3–200 characters.

Exemplo de requisição

curl https://api.latinfo.dev/pe/osce/cod-cuadernos/search?q=q \
  -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.

X-Total-Count

Exact row count for this identifier when pagination is requested.

X-Page-Offset

integer

X-Page-Limit

integer

Link

Next page URL, rel=next. Absent at the end.

Content-Type: application/json

Campos da resposta

[].id string
[].razon_social_contratista string

Registered name of the principal contractor.

[].razon_social_entidad string

Name of the contracting public entity.

Esquema de resposta
{
  "type": "array",
  "items": {
    "type": "object",
    "properties": {
      "id": {
        "type": "string"
      },
      "razon_social_contratista": {
        "type": "string",
        "description": "Registered name of the principal contractor.",
        "x-latinfo-meaning": "text"
      },
      "razon_social_entidad": {
        "type": "string",
        "description": "Name of the contracting public entity.",
        "x-latinfo-meaning": "text"
      }
    }
  }
}
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.
409Source generation changed during paginated retrieval. Restart from offset 0.
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.

[
  {
    "id": "string",
    "razon_social_contratista": "string",
    "razon_social_entidad": "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.

Esc