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

# Trámites del Estado colombiano (SUIT)

> Busca en todos los trámites que ofrecen las entidades nacionales y territoriales de Colombia, y lee cualquiera completo: requisitos, tarifas, pasos, canales, tiempo de obtención y puntos de atención.

El Sistema Único de Información de Trámites (SUIT), a cargo de Función Pública, es el registro oficial de todos los trámites que una entidad pública colombiana ofrece a personas y empresas: desde el pasaporte o el duplicado de la cédula hasta un permiso municipal. gov.co muestra cada uno como una página de trámite numerada `T` más su número único.

Cada trámite llega con su entidad, el orden y el municipio de la entidad, si se puede hacer en línea, y su información completa: propósito, a quién va dirigido, cada paso con sus documentos, condiciones, canales, formularios y tarifas, excepciones, fundamento legal y puntos de atención. `modified_at` dice cuándo lo actualizó la entidad por última vez.

Busca en entidades nacionales y territoriales con texto libre que llega hasta los requisitos y las tarifas, o filtra por orden, entidad o departamento y municipio DANE.

<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 trámites

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

Una sola búsqueda sobre todos los trámites de todas las entidades públicas, nacionales y territoriales, que llega hasta los requisitos y las tarifas.

| Campo | Tipo | Notas |
| - | - | - |
| `query` | string | Palabras opcionales que se buscan en el nombre, la entidad, el propósito y la información completa del trámite, p. ej. `pasaporte` o `duplicado cédula`. |
| `order` | enum | Opcional: `national` para entidades nacionales, `territorial` para departamentos, distritos y municipios, `any` para ambas. Por defecto `any`. |
| `entity_code` | string | Opcional: solo trámites de la entidad con este código, como lo da `entity_code` en un resultado, p. ej. `5396` para la Registraduría. |
| `department_code` | string | Código DANE opcional de dos dígitos del departamento de la entidad, p. ej. `05` para Antioquia. |
| `municipality_code` | string | Código DANE opcional de cinco dígitos del municipio de la entidad, p. ej. `11001` para Bogotá. |
| `page` | integer | Número de página, empieza en 1. Por defecto `1`. |
| `per_page` | integer | Resultados por página (1-50). Por defecto `20`. |

```bash theme={"dark"}
curl https://api.croma.run/co/suit/procedures-search/v1 \
  -H "Authorization: Bearer $CROMA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "query": "duplicado cédula", "order": "national" }'
```

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 número único del trámite, que gov.co muestra como `T44`), `number`, `name`, `purpose`, `result` (lo que obtiene la persona), `time_to_obtain`, `procedure_class` (`UNICO` para un trámite propio de una entidad, `MODELO` para uno estándar que ofrecen muchas), `state`, `version`, `entity_code`, `entity_name`, `entity_order` (`NACIONAL` o `TERRITORIAL`), `entity_level` (`MUNICIPAL`, `DEPARTAMENTAL` o `DISTRITAL` para entidades territoriales), `department_code` y `municipality_code` (DANE), `municipality_name`, `online` (`TOTALMENTE`, `PARCIALMENTE` o `NO`), `online_url`, `manual_url`, `entity_url`, `modified_at` (cuándo se actualizó por última vez la información del trámite), `created_at` y `official_url` (el trámite en gov.co).

<Note>
  Los resultados de búsqueda no incluyen la información completa del trámite. `query` sí busca dentro de ella, así que un requisito o una tarifa encuentran el trámite; para leerlo completo usa el endpoint Colombia Procedure.
</Note>

## Un trámite, completo

`POST /co/suit/procedure/v1` <a className="dataset-pill" href="/es/datasets">Dataset</a>

| Campo | Tipo | Notas |
| - | - | - |
| `procedure_id` | string | **Obligatorio.** El número único del trámite, p. ej. `44`, también como `T44`, o su `official_url` en gov.co. |
| `offset` | integer | Primer carácter del texto a devolver. Envía el `next_offset` de la respuesta anterior para seguir leyendo. Por defecto `0`. |
| `limit` | integer | Cuántos caracteres del texto devolver. La mayoría de los trámites caben en una sola respuesta. Por defecto `200000`. |

```bash theme={"dark"}
curl https://api.croma.run/co/suit/procedure/v1 \
  -H "Authorization: Bearer $CROMA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "procedure_id": "T44" }'
```

Devuelve `as_of`, `found`, `procedure_id` y `procedure`, que trae todo lo que devuelve la búsqueda más `content`: la información completa del trámite en markdown (propósito, a quién va dirigido, cada paso con sus documentos, condiciones, canales, formularios y tarifas, excepciones, fundamento legal y puntos de atención), con `text`, `offset`, `total_length`, `has_more` y `next_offset`. Cada resultado incluye `id` (el número único del trámite, que gov.co muestra como `T44`), `number`, `name`, `purpose`, `result` (lo que obtiene la persona), `time_to_obtain`, `procedure_class` (`UNICO` para un trámite propio de una entidad, `MODELO` para uno estándar que ofrecen muchas), `state`, `version`, `entity_code`, `entity_name`, `entity_order` (`NACIONAL` o `TERRITORIAL`), `entity_level` (`MUNICIPAL`, `DEPARTAMENTAL` o `DISTRITAL` para entidades territoriales), `department_code` y `municipality_code` (DANE), `municipality_name`, `online` (`TOTALMENTE`, `PARCIALMENTE` o `NO`), `online_url`, `manual_url`, `entity_url`, `modified_at` (cuándo se actualizó por última vez la información del trámite), `created_at` y `official_url` (el trámite en gov.co).

<Note>
  Las tarifas y los requisitos son los que la entidad publicó por última vez en el registro; `modified_at` dice cuándo. La página de la propia entidad puede ser más reciente.
</Note>

<Note>
  Un número único que el registro no tiene 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.