> ## 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. # Procedimentos do Estado colombiano (SUIT) > Busque em todos os procedimentos que as entidades nacionais e territoriais da Colômbia oferecem, e leia qualquer um completo: requisitos, tarifas, etapas, canais, prazo e pontos de atendimento. O Sistema Único de Información de Trámites (SUIT), a cargo da Función Pública, é o registro oficial de todos os procedimentos que uma entidade pública colombiana oferece a cidadãos e empresas: do passaporte ou da segunda via da cédula a uma licença municipal. O gov.co mostra cada um como uma página de procedimento numerada `T` mais o seu número único. Cada procedimento chega com sua entidade, a ordem e o município da entidade, se pode ser feito online, e suas informações completas: propósito, a quem se destina, cada etapa com seus documentos, condições, canais, formulários e tarifas, exceções, fundamento legal e pontos de atendimento. `modified_at` diz quando a entidade o atualizou pela última vez. Busque em entidades nacionais e territoriais com texto livre que alcança requisitos e tarifas, ou filtre por ordem, entidade ou departamento e município DANE. 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). ## Buscar procedimentos `POST /co/suit/procedures-search/v1` Dataset Uma única busca sobre todos os procedimentos de todas as entidades públicas, nacionais e territoriais, que alcança requisitos e tarifas. | Campo | Tipo | Notas | | - | - | - | | `query` | string | Palavras opcionais buscadas no nome, na entidade, no propósito e nas informações completas do procedimento, p. ex. `pasaporte` ou `duplicado cédula`. | | `order` | enum | Opcional: `national` para entidades nacionais, `territorial` para departamentos, distritos e municípios, `any` para ambas. Por padrão `any`. | | `entity_code` | string | Opcional: só procedimentos da entidade com este código, como `entity_code` o dá em um resultado, p. ex. `5396` para a Registraduría. | | `department_code` | string | Código DANE opcional de dois dígitos do departamento da entidade, p. ex. `05` para Antioquia. | | `municipality_code` | string | Código DANE opcional de cinco dígitos do município da entidade, p. ex. `11001` para Bogotá. | | `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 `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" }' ``` 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 número único do procedimento, que o gov.co mostra como `T44`), `number`, `name`, `purpose`, `result` (o que a pessoa obtém), `time_to_obtain`, `procedure_class` (`UNICO` para um procedimento próprio de uma entidade, `MODELO` para um padrão que muitas oferecem), `state`, `version`, `entity_code`, `entity_name`, `entity_order` (`NACIONAL` ou `TERRITORIAL`), `entity_level` (`MUNICIPAL`, `DEPARTAMENTAL` ou `DISTRITAL` para entidades territoriais), `department_code` e `municipality_code` (DANE), `municipality_name`, `online` (`TOTALMENTE`, `PARCIALMENTE` ou `NO`), `online_url`, `manual_url`, `entity_url`, `modified_at` (quando as informações do procedimento foram atualizadas pela última vez), `created_at` e `official_url` (o procedimento no gov.co). Os resultados da busca não incluem as informações completas do procedimento. `query` busca dentro delas, então um requisito ou uma tarifa encontram o procedimento; para lê-lo completo use o endpoint Colombia Procedure. ## Um procedimento, completo `POST /co/suit/procedure/v1` Dataset | Campo | Tipo | Notas | | - | - | - | | `procedure_id` | string | **Obrigatório.** O número único do procedimento, p. ex. `44`, também como `T44`, ou sua `official_url` no gov.co. | | `offset` | integer | Primeiro caractere do texto a retornar. Envie o `next_offset` da resposta anterior para continuar lendo. Por padrão `0`. | | `limit` | integer | Quantos caracteres do texto retornar. A maioria dos procedimentos cabe em uma resposta. Por padrão `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" }' ``` Retorna `as_of`, `found`, `procedure_id` e `procedure`, que traz tudo o que a busca retorna mais `content`: as informações completas do procedimento em markdown (propósito, a quem se destina, cada etapa com seus documentos, condições, canais, formulários e tarifas, exceções, fundamento legal e pontos de atendimento), com `text`, `offset`, `total_length`, `has_more` e `next_offset`. Cada resultado traz `id` (o número único do procedimento, que o gov.co mostra como `T44`), `number`, `name`, `purpose`, `result` (o que a pessoa obtém), `time_to_obtain`, `procedure_class` (`UNICO` para um procedimento próprio de uma entidade, `MODELO` para um padrão que muitas oferecem), `state`, `version`, `entity_code`, `entity_name`, `entity_order` (`NACIONAL` ou `TERRITORIAL`), `entity_level` (`MUNICIPAL`, `DEPARTAMENTAL` ou `DISTRITAL` para entidades territoriais), `department_code` e `municipality_code` (DANE), `municipality_name`, `online` (`TOTALMENTE`, `PARCIALMENTE` ou `NO`), `online_url`, `manual_url`, `entity_url`, `modified_at` (quando as informações do procedimento foram atualizadas pela última vez), `created_at` e `official_url` (o procedimento no gov.co). As tarifas e os requisitos são os que a entidade publicou por último no registro; `modified_at` diz quando. A página da própria entidade pode ser mais recente. Um número único que o registro não tem retorna `found: false` com HTTP 200, não um erro. Esquemas, todos os campos de resposta e um playground interativo. This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.