> ## 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 trámites de las entidades

> Lo que las entidades colombianas publican sobre sus propios trámites: requisitos, tarifas, dónde hacerlos, tiempos de entrega y preguntas frecuentes.

Las páginas de trámites de los sitios de las propias entidades colombianas, en markdown: lo que la entidad misma dice sobre requisitos, tarifas y medios de pago, dónde hacer el trámite, tiempos de entrega y sus preguntas frecuentes. Complementan el registro nacional de trámites ([Trámites SUIT](/es/guides/colombia/suit)): la página de la entidad suele ser la palabra más reciente sobre tarifas y trae los detalles que el registro no incluye.

Hoy cubre el Ministerio de Relaciones Exteriores (Cancillería: pasaportes, visas, apostillas, servicios consulares) y la Unidad para las Víctimas (Registro Único de Víctimas, declaración, ayuda humanitaria, indemnización). Vienen más entidades.

Busca en todas las páginas con texto libre, o filtra por entidad, y lee cualquier página completa.

<Note>
  La fuente entera, organizada y lista para consultar: cada endpoint de esta página responde en milisegundos. Cada respuesta incluye `as_of`: qué tan actualizados están los datos. [Cómo funcionan los datasets](/es/datasets).
</Note>

## Buscar páginas

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

Una sola búsqueda sobre todas las páginas de trámites de las entidades cubiertas, que llega hasta su contenido completo.

| Campo | Tipo | Notas |
| - | - | - |
| `query` | string | Palabras opcionales que se buscan en el título y el contenido de cada página, p. ej. `pasaporte costos`. |
| `site` | enum | Opcional: `cancilleria` o `unidad-victimas`. |
| `page` | integer | Número de página, empieza en 1. Por defecto `1`. |
| `per_page` | integer | Resultados por página (1-50). Por defecto `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" }'
```

Devuelve `as_of` (qué tan actualizados están los datos), los filtros aplicados, `total` y `total_is_exact`, `page`, `per_page`, `total_pages`, `count` y `results[]`, del más pertinente al menos cuando se envía `query`. Cada resultado incluye `id` (el identificador permanente de la página), `site` (`cancilleria` o `unidad-victimas`), `entity`, `url` (la página en el sitio de la entidad), `title` y `modified_at` (cuándo la entidad cambió la página por última vez, cuando su sitio lo indica).

<Note>
  Los resultados de búsqueda no incluyen el contenido de la página. `query` sí busca dentro de él; para leer una página completa usa el endpoint Colombia Entity Procedure Page.
</Note>

## Una página, completa

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

| Campo | Tipo | Notas |
| - | - | - |
| `page_id` | string | **Obligatorio.** El `id` de la página que devuelve la búsqueda, o su `url`. |
| `offset` | integer | Primer carácter del contenido a devolver. Envía el `next_offset` de la respuesta anterior para seguir leyendo. Por defecto `0`. |
| `limit` | integer | Cuántos caracteres devolver. La mayoría de las páginas caben en una sola respuesta. Por defecto `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"
      }'
```

Devuelve `as_of`, `found`, `page_id` y `page`, que trae todo lo que devuelve la búsqueda más `content`: el contenido de la página en markdown, con sus enlaces, con `text`, `offset`, `total_length`, `has_more` y `next_offset`. Cada resultado incluye `id` (el identificador permanente de la página), `site` (`cancilleria` o `unidad-victimas`), `entity`, `url` (la página en el sitio de la entidad), `title` y `modified_at` (cuándo la entidad cambió la página por última vez, cuando su sitio lo indica).

<Note>
  Una página que la entidad ya no publica devuelve `found: false` con HTTP 200, no un error.
</Note>

<Card title="Referencia completa" icon="code" href="/es/api-reference/overview">
  Esquemas, todos los campos de respuesta y un playground interactivo.
</Card>


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