---
title: "Colombia Entity Procedure Pages Search"
method: POST
path: "/co/gov-pages/search/v1"
tags: ["Colombia", "Páginas de trámites"]
---

# Colombia Entity Procedure Pages Search

`POST /co/gov-pages/search/v1`

## Request

- Base URL: `https://api.croma.run`
- URL: `https://api.croma.run/co/gov-pages/search/v1`
- Auth: HTTP bearer

Search the procedure pages Colombian entities publish on their own sites: requirements, fees and how to pay, where to apply, delivery times and FAQs. Covers the Cancillería (passports, visas, apostilles) and the Unidad para las Víctimas (Registro Único de Víctimas, humanitarian aid, compensation). Free text matches each page's title and full content; filter by `site`. Served by Croma (`as_of` says how current the data is).

**Dataset endpoint**: answers from the whole source in milliseconds and carries `as_of`.

## Headers

- `Idempotency-Key` string

## Request body

- object
  - `query` string: Optional search terms matched against each page's title and full text, e.g. `pasaporte costos` or `registro único de víctimas`.
  - `site` '' | 'cancilleria' | 'unidad-victimas': Optional: only the pages of `cancilleria` (Ministerio de Relaciones Exteriores) or `unidad-victimas` (Unidad para las Víctimas).
  - `page` integer: 1-based page number for paginated results.
  - `per_page` integer: Results per page (1-50).

## Response `200`

Successful response

- GovPagesSearchResponse
  - `data` GovPagesSearchData, required
    - `as_of` string, nullable, required: How current the data in this response is.
    - `query` string, required
    - `site` string, nullable, required
    - `total` number, required: Matches, counted up to 1000.
    - `total_is_exact` boolean, required: False when more than 1000 match.
    - `page` number, required
    - `per_page` number, required
    - `total_pages` number, required
    - `count` number, required
    - `results` object[], required
      - `id` string, required: The page's permanent id: a short hash of its address.
      - `site` string, required: Which entity's site: `cancilleria` or `unidad-victimas`.
      - `entity` string, required: The entity that publishes the page.
      - `url` string, required: The page's address on the entity's site.
      - `title` string, nullable, required: The page's own title.
      - `modified_at` string, nullable, required: When the entity last changed the page, ISO 8601, when its site says so.

## Other responses

- `400`: Invalid request body
- `401`: Missing or invalid API key
- `429`: Rate limit exceeded
- `500`: Internal error
- `502`: Upstream source returned an error

---

[API](https://skmtc.dev/usecroma/apis/croma-marketplace-api.md) · [All operations](https://skmtc.dev/usecroma/apis/croma-marketplace-api/llms.txt) · [OpenAPI document](https://skmtc.dev/usecroma/apis/croma-marketplace-api/revisions/df016cdb29d7?raw)