English
EspañolEnglishPortuguêsFilipino
Get free API key
Colombia · co_cce_secop_providers_search
OpenAPI

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.

Source contract

Publisher
Colombia Compra Eficiente
Coverage
Corporate providers registered in SECOP II; not all Colombian companies.
Record meaning
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.
Accepted pattern
^\d{6,10}$
Normalization
coNit
Cardinality
many
License
Reuse permission has not been verified. Public access is not a reuse license.

Known limitations

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

Machine-readable source contract · Source documentation

Authentication required. REST requests use a Latinfo API key. The interactive console builds the authorization header and does not store the key.

Parameters

qstringqueryrequired

Name query, 3–200 characters.

Request example

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

Responses

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

Response headers

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

Response fields

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

Value meanings

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.
No response body documented.
401Missing or invalid API key. Authenticate before retrying.
No response body documented.
404No published record, or identifier outside the legal-entity scope. Not proof that the company does not exist.
No response body documented.
409Source generation changed during paginated retrieval. Restart from offset 0.
No response body documented.
429Rate or credit limit exceeded. Inspect the response and rate-limit headers before retrying.
No response body documented.
503Source unavailable. Report unavailable, not an empty result.
No response body documented.
Example JSON

Illustrative schema example. This is not a live response.

[
  {
    "id": "string",
    "company_name": "string",
    "active": "Si"
  }
]

Provenance and limitations

Coverage varies by country and public source. A missing field is not evidence that the underlying fact does not exist. Public registries may be delayed or contain source errors; inspect the returned evidence and source date before relying on a result.

Esc