Search cce · secop-providers

GET https://api.latinfo.dev/co/cce/secop-providers/search

Search the published company_name 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: Colombia Compra Eficiente
Cobertura: Corporate providers registered in SECOP II; not all Colombian companies.
Significado do registro: A published provider registration with declared organizational contact channels.
Identificador: Use the NIT body without check digit. coNit normalizes accepted inputs to the zero-padded stored body; keep it as a string.
Padrão aceito: ^\d{6,10}$
Normalização: coNit
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

Provider contact channels may identify named contacts; use only for the stated business purpose.

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/co/cce/secop-providers/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

[].company_name string

Company name published by the authority.

[].active string

SECOP II provider-account status; not tax or legal-registration status.

Si · No

Significado dos valores

PROCUREMENT_SUPPLIER_REGISTRATION

Si

Active: Colombia Compra Eficiente reports this SECOP II provider account as active.

No

Inactive: Colombia Compra Eficiente reports this SECOP II provider account as inactive.

Esquema de resposta

{
  "type": "array",
  "items": {
    "type": "object",
    "properties": {
      "id": {
        "type": "string"
      },
      "company_name": {
        "type": "string",
        "description": "Company name published by the authority.",
        "x-latinfo-meaning": "text"
      },
      "active": {
        "type": "string",
        "description": "SECOP II provider-account status; not tax or legal-registration status.",
        "x-latinfo-meaning": "text",
        "enum": [
          "Si",
          "No"
        ],
        "x-latinfo-vocabulary": {
          "id": "co.cce.secop_provider_status.v1",
          "scope": "PROCUREMENT_SUPPLIER_REGISTRATION",
          "empty_policy": "reject",
          "values": {
            "Si": {
              "code": "ACTIVE",
              "label_en": "Active",
              "explanation_en": "Colombia Compra Eficiente reports this SECOP II provider account as active."
            },
            "No": {
              "code": "INACTIVE",
              "label_en": "Inactive",
              "explanation_en": "Colombia Compra Eficiente reports this SECOP II provider account as inactive."
            }
          }
        }
      }
    }
  }
}

400Invalid identifier or query. Correct the input before retrying.