> ## Documentation Index
> Fetch the complete documentation index at: https://docs.usecroma.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Páginas de procedimentos das entidades

> O que as entidades colombianas publicam sobre seus próprios procedimentos: requisitos, tarifas, onde solicitar, prazos de entrega e perguntas frequentes.

As páginas de procedimentos dos sites das próprias entidades colombianas, em markdown: o que a própria entidade diz sobre requisitos, tarifas e meios de pagamento, onde solicitar, prazos de entrega e suas perguntas frequentes. Complementam o registro nacional de procedimentos ([Trámites SUIT](/pt/guides/colombia/suit)): a página da entidade costuma ser a informação mais recente sobre tarifas e traz os detalhes que o registro não inclui.

Hoje cobre o Ministerio de Relaciones Exteriores (Cancillería: passaportes, vistos, apostilas, serviços consulares) e a Unidad para las Víctimas (Registro Único de Víctimas, declaração, ajuda humanitária, indenização). Mais entidades virão.

Busque em todas as páginas com texto livre, ou filtre por entidade, e leia qualquer página completa.

<Note>
  A fonte inteira, organizada e pronta para consultar: cada endpoint desta página responde em milissegundos. Cada resposta traz `as_of`: o quão atuais são os dados. [Como funcionam os datasets](/pt/datasets).
</Note>

## Buscar páginas

`POST /co/gov-pages/search/v1` <a className="dataset-pill" href="/pt/datasets">Dataset</a>

Uma única busca sobre todas as páginas de procedimentos das entidades cobertas, que alcança seu conteúdo completo.

| Campo | Tipo | Notas |
| - | - | - |
| `query` | string | Palavras opcionais buscadas no título e no conteúdo de cada página, p. ex. `pasaporte costos`. |
| `site` | enum | Opcional: `cancilleria` ou `unidad-victimas`. |
| `page` | integer | Número da página, começa em 1. Por padrão `1`. |
| `per_page` | integer | Resultados por página (1-50). Por padrão `10`. |

```bash theme={"dark"}
curl https://api.croma.run/co/gov-pages/search/v1 \
  -H "Authorization: Bearer $CROMA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "query": "pasaporte costos", "site": "cancilleria" }'
```

Retorna `as_of` (o quão atuais são os dados), os filtros aplicados, `total` e `total_is_exact`, `page`, `per_page`, `total_pages`, `count` e `results[]`, do mais pertinente ao menos quando `query` é enviada. Cada resultado traz `id` (o identificador permanente da página), `site` (`cancilleria` ou `unidad-victimas`), `entity`, `url` (a página no site da entidade), `title` e `modified_at` (quando a entidade alterou a página pela última vez, quando o site informa).

<Note>
  Os resultados da busca não incluem o conteúdo da página. `query` busca dentro dele; para ler uma página completa use o endpoint Colombia Entity Procedure Page.
</Note>

## Uma página, completa

`POST /co/gov-pages/page/v1` <a className="dataset-pill" href="/pt/datasets">Dataset</a>

| Campo | Tipo | Notas |
| - | - | - |
| `page_id` | string | **Obrigatório.** O `id` da página retornado pela busca, ou sua `url`. |
| `offset` | integer | Primeiro caractere do conteúdo a retornar. Envie o `next_offset` da resposta anterior para continuar lendo. Por padrão `0`. |
| `limit` | integer | Quantos caracteres retornar. A maioria das páginas cabe em uma resposta. Por padrão `200000`. |

```bash theme={"dark"}
curl https://api.croma.run/co/gov-pages/page/v1 \
  -H "Authorization: Bearer $CROMA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
        "page_id": "https://www.cancilleria.gov.co/atencion-y-servicio-al-ciudadano/tramites-y-servicios/pasaportes/costos-y-medios-de-pago"
      }'
```

Retorna `as_of`, `found`, `page_id` e `page`, que traz tudo o que a busca retorna mais `content`: o conteúdo da página em markdown, com seus links, com `text`, `offset`, `total_length`, `has_more` e `next_offset`. Cada resultado traz `id` (o identificador permanente da página), `site` (`cancilleria` ou `unidad-victimas`), `entity`, `url` (a página no site da entidade), `title` e `modified_at` (quando a entidade alterou a página pela última vez, quando o site informa).

<Note>
  Uma página que a entidade não publica mais retorna `found: false` com HTTP 200, não um erro.
</Note>

<Card title="Referência completa" icon="code" href="/pt/api-reference/overview">
  Esquemas, todos os campos de resposta e um playground interativo.
</Card>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.