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.

Kontrata ng source

Publisher: Colombia Compra Eficiente
Saklaw: Corporate providers registered in SECOP II; not all Colombian companies.
Kahulugan ng tala: A published provider registration with declared organizational contact channels.
Identifier: Use the NIT body without check digit. coNit normalizes accepted inputs to the zero-padded stored body; keep it as a string.
Tinatanggap na pattern: ^\d{6,10}$
Normalization: coNit
Bilang ng mga tala: many
Lisensya: Hindi pa nabeberipika ang pahintulot sa muling paggamit. Hindi lisensya sa muling paggamit ang pampublikong access.

Mga kilalang limitasyon

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

Kontrata ng source para sa mga agent · Dokumentasyon ng source

Kailangan ng authentication. Gumagamit ang REST request ng Latinfo api key. Idinaragdag ng console ang authorization header at hindi iniimbak ang key.

Mga parameter

qstringquerykailangan

Name query, 3–200 characters.

Halimbawa ng request

curl https://api.latinfo.dev/co/cce/secop-providers/search?q=q \
  -H "Authorization: Bearer $LATINFO_API_KEY"

Mga tugon

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

Mga header ng tugon

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

Mga field ng tugon

[].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

Kahulugan ng mga value

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.

Response schema

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