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

# Colombia Entity Procedure Page

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

## Request

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

Read one procedure page of a Colombian entity's own site in full, as markdown with its links, by its `id` from a search result or by its address: requirements, fees and how to pay, where to apply, delivery times or FAQs, as the entity publishes them. The text comes back a character range at a time (`offset`, `limit`); follow `next_offset` until `has_more` is false.

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

## Headers

- `Idempotency-Key` string

## Request body

- object
  - `page_id` string, required: The page's `id` from a search result, or its `url`.
  - `offset` integer: First character of the range to return. Pass the previous response's `next_offset` to continue reading.
  - `limit` integer: Maximum characters to return (1000-1000000).

## Response `200`

Successful response

- GovPageResponse
  - `data` GovPageData, required
    - `as_of` string, nullable, required: How current the data in this response is.
    - `found` boolean, required
    - `page_id` string, required
    - `page` object, nullable, 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.
      - `content` object, nullable, required: A range of the page's content as markdown.
        - `text` string, required: The requested character range of the page's content, as markdown.
        - `offset` number, required: First character of the range.
        - `total_length` number, required: Length of the whole content in characters.
        - `has_more` boolean, required: Whether the content continues past this range.
        - `next_offset` number, nullable, required: Pass this back as `offset` to read the next range. Null at the end.

## 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)