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

# SIGEP II

> Busque no diretório de servidores públicos e contratados da Colômbia, leia a hoja de vida de uma pessoa e consulte qualquer entidade do Estado no SIGEP II.

O SIGEP II é o registro do Departamento Administrativo de la Función Pública de
quem trabalha para o Estado colombiano. Cada entidade informa ali seus
servidores públicos e contratados, com o cargo que ocupam, sua formação e
experiência, os contratos vigentes e a escala salarial da entidade, e o
diretório de entidades registra o NIT, a natureza jurídica, a ordem, o setor e
a localização de cada uma.

Busque pessoas por nome, entidade ou cidade e filtre por departamento,
município, entidade ou tipo de vínculo; leia uma hoja de vida completa; busque
entidades; e consulte a ficha de uma entidade.

## Buscar pessoas

`POST /co/sigep/servants-search/v1` [Live](https://docs.usecroma.com/pt/live-lookups.md)

Uma busca sobre todas as pessoas que as entidades informam ao SIGEP II, servidores e contratados.

| Campo | Tipo | Notas |
| - | - | - |
| `query` | string | Nomes e sobrenomes, uma entidade ou uma cidade. Opcional se um filtro for enviado. |
| `department` | string | Departamento opcional do cargo, p. ex. `CÓRDOBA`. Acentos e maiúsculas são opcionais. |
| `municipality` | string | Município opcional do cargo, p. ex. `MONTERÍA`. Acentos e maiúsculas são opcionais. |
| `entity_code` | string | Código SIGEP opcional de uma entidade: `facets.entities[].code`, ou `sigep_code` dos endpoints de entidades. |
| `employment_type` | enum | Opcional: `servidor_publico` ou `contratista`. |
| `page` | integer | Número da página, começa em 1. Por padrão `1`. |
| `per_page` | integer | Resultados por página (1-100). Por padrão `20`. |

```bash theme={"dark"}
curl https://api.croma.run/co/sigep/servants-search/v1 \
  -H "Authorization: Bearer $CROMA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
        "query": "alcaldia de monteria",
        "employment_type": "servidor_publico"
      }'
```

Retorna os filtros aplicados, `total`, `total_pages`, `page`, `per_page`, `count`, `results[]` e `facets`.

| Campo | Notas |
| - | - |
| `results[].id` | Id da hoja de vida: envie-o como `servant_id` ao SIGEP II Person. |
| `results[].full_name` | Nomes e sobrenomes como publicados. |
| `results[].employment_type` | `servidor_publico` ou `contratista`, com o rótulo do diretório em `employment_type_label`. |
| `results[].entity` / `entity_code` | A entidade à qual a pessoa está vinculada e seu código SIGEP. |
| `results[].phone`, `city`, `department` | Telefone de contato e local do cargo, como a entidade os informou. |
| `results[].url` | A página da pessoa no diretório público. |
| `facets` | `departments[]`, `municipalities[]`, `entities[]` (com `code`) e `employment_types[]`, cada um com `name` e `count`: como os resultados se distribuem e os valores exatos que os filtros aceitam. |

> [!NOTE]
>
> Os filtros de departamento e município são comparados com a grafia do
> diretório. `cordoba` e `CÓRDOBA` funcionam igual: a resposta repete a
> grafia aplicada.

## Uma hoja de vida

`POST /co/sigep/servant/v1` [Live](https://docs.usecroma.com/pt/live-lookups.md)

| Campo | Tipo | Notas |
| - | - | - |
| `servant_id` | string | **Obrigatório.** O `id` do SIGEP II People Search, p. ex. `S2060152-4395-4`. |

```bash theme={"dark"}
curl https://api.croma.run/co/sigep/servant/v1 \
  -H "Authorization: Bearer $CROMA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "servant_id": "S2060152-4395-4" }'
```

Retorna `found`, `servant_id` e `servant`:

| Campo | Notas |
| - | - |
| `full_name`, `position`, `employment_type` | Quem é a pessoa e o cargo que ocupa. |
| `entity`, `dependency` | A entidade e a unidade dentro dela. |
| `email`, `phone`, `fax` | Dados de contato como a entidade os informou; `null` quando não informados. |
| `birthplace` | `municipality`, `department`, `country`. |
| `education[]` | `level`, `program`, `status` e a linha `raw`. |
| `experience[]` | `position`, `entity`, `start_date`, `end_date` (`yyyy-mm-dd`) e `current`. |
| `contracts[]` | Contratos vigentes: `entity`, `object`, `start_date`, `end_date`, `amount` (COP) e `amount_text`. |
| `salary_scale[]` | A escala salarial da entidade (`salary_scale_entity`): `level`, `denomination`, `grade`, `total` (COP mensal). |

> [!NOTE]
>
> Um id que o diretório não tem retorna `found: false` com HTTP 200.

## Buscar entidades

`POST /co/sigep/entities-search/v1` [Live](https://docs.usecroma.com/pt/live-lookups.md)

| Campo | Tipo | Notas |
| - | - | - |
| `query` | string | Palavras opcionais do nome da entidade. Vazio lista todas as entidades. |
| `department` | string | Departamento opcional. Acentos, maiúsculas e pontuação são ignorados. |
| `municipality` | string | Município opcional. Acentos, maiúsculas e pontuação são ignorados. |
| `order` | enum | Opcional: `nacional` ou `territorial`. |
| `page` | integer | Número da página, começa em 1. Por padrão `1`. |
| `per_page` | integer | Resultados por página (1-100). Por padrão `20`. |

```bash theme={"dark"}
curl https://api.croma.run/co/sigep/entities-search/v1 \
  -H "Authorization: Bearer $CROMA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "query": "alcaldia", "department": "antioquia" }'
```

Retorna os filtros aplicados, `total`, `total_pages`, `page`, `per_page`, `count` e `results[]`. Cada entidade traz `entity_id`, `sigep_code`, `name`, `nit` e `verification_digit`, `status`, `entity_type`, `order` e `sub_order`, `organic_classification`, `administrative_sector`, `legal_nature`, `administrative_level`, `legal_personality`, `own_assets`, `post_conflict`, `department`, `municipality`, `dane_code`, `cuin_code`, `dnp_category`, `zone_type`, `address`, `email`, `website`, `phone`, `mobile`, `legal_representative`, `parent_entity`, `latitude` e `longitude`.

## Uma entidade

`POST /co/sigep/entity/v1` [Live](https://docs.usecroma.com/pt/live-lookups.md)

| Campo | Tipo | Notas |
| - | - | - |
| `entity_id` | integer | **Obrigatório.** O `entity_id` do SIGEP II Entities Search, p. ex. `3098`. |

```bash theme={"dark"}
curl https://api.croma.run/co/sigep/entity/v1 \
  -H "Authorization: Bearer $CROMA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "entity_id": 3098 }'
```

Retorna `found`, `entity_id` e `entity`. Cada entidade traz `entity_id`, `sigep_code`, `name`, `nit` e `verification_digit`, `status`, `entity_type`, `order` e `sub_order`, `organic_classification`, `administrative_sector`, `legal_nature`, `administrative_level`, `legal_personality`, `own_assets`, `post_conflict`, `department`, `municipality`, `dane_code`, `cuin_code`, `dnp_category`, `zone_type`, `address`, `email`, `website`, `phone`, `mobile`, `legal_representative`, `parent_entity`, `latitude` e `longitude`. Também traz `career_systems[]` (`code`, `name`), `salary_regimes[]` e `employment_natures[]`.

> [!NOTE]
>
> Um id que o diretório não tem retorna `found: false` com HTTP 200.

> [card] [Referência completa](https://docs.usecroma.com/pt/api-reference/overview.md)
>
> 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.