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

> Busca en el directorio de servidores públicos y contratistas de Colombia, lee la hoja de vida de una persona y consulta cualquier entidad del Estado en SIGEP II.

SIGEP II es el registro del Departamento Administrativo de la Función Pública de
quiénes trabajan para el Estado colombiano. Cada entidad reporta allí a sus
servidores públicos y contratistas, con el cargo que ocupan, su formación y
experiencia, los contratos vigentes y la escala salarial de la entidad, y el
directorio de entidades registra el NIT, la naturaleza jurídica, el orden, el
sector y la ubicación de cada una.

Busca personas por nombre, entidad o ciudad y filtra por departamento,
municipio, entidad o tipo de vinculación; lee una hoja de vida completa; busca
entidades; y consulta la ficha de una entidad.

## Buscar personas

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

Una búsqueda sobre todas las personas que las entidades reportan a SIGEP II, servidores y contratistas.

| Campo | Tipo | Notas |
| - | - | - |
| `query` | string | Nombres y apellidos, una entidad o una ciudad. Opcional si se envía un filtro. |
| `department` | string | Departamento opcional del cargo, p. ej. `CÓRDOBA`. Tildes y mayúsculas son opcionales. |
| `municipality` | string | Municipio opcional del cargo, p. ej. `MONTERÍA`. Tildes y mayúsculas son opcionales. |
| `entity_code` | string | Código SIGEP opcional de una entidad: `facets.entities[].code`, o `sigep_code` de los endpoints de entidades. |
| `employment_type` | enum | Opcional: `servidor_publico` o `contratista`. |
| `page` | integer | Número de página, empieza en 1. Por defecto `1`. |
| `per_page` | integer | Resultados por página (1-100). Por defecto `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"
      }'
```

Devuelve los filtros aplicados, `total`, `total_pages`, `page`, `per_page`, `count`, `results[]` y `facets`.

| Campo | Notas |
| - | - |
| `results[].id` | Id de la hoja de vida: envíalo como `servant_id` a SIGEP II Person. |
| `results[].full_name` | Nombres y apellidos tal como se publican. |
| `results[].employment_type` | `servidor_publico` o `contratista`, con la etiqueta del directorio en `employment_type_label`. |
| `results[].entity` / `entity_code` | La entidad a la que está vinculada la persona y su código SIGEP. |
| `results[].phone`, `city`, `department` | Teléfono de contacto y lugar del cargo, según los reportó la entidad. |
| `results[].url` | La página de la persona en el directorio público. |
| `facets` | `departments[]`, `municipalities[]`, `entities[]` (con `code`) y `employment_types[]`, cada uno con `name` y `count`: cómo se reparten los resultados y los valores exactos que aceptan los filtros. |

> [!NOTE]
>
> Los filtros de departamento y municipio se comparan con la grafía del
> directorio. `cordoba` y `CÓRDOBA` funcionan igual: la respuesta repite la
> grafía que se aplicó.

## Una hoja de vida

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

| Campo | Tipo | Notas |
| - | - | - |
| `servant_id` | string | **Obligatorio.** El `id` de SIGEP II People Search, p. ej. `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" }'
```

Devuelve `found`, `servant_id` y `servant`:

| Campo | Notas |
| - | - |
| `full_name`, `position`, `employment_type` | Quién es la persona y el cargo que ocupa. |
| `entity`, `dependency` | La entidad y la dependencia dentro de ella. |
| `email`, `phone`, `fax` | Datos de contacto según los reportó la entidad; `null` cuando no se reportaron. |
| `birthplace` | `municipality`, `department`, `country`. |
| `education[]` | `level`, `program`, `status` y la línea `raw`. |
| `experience[]` | `position`, `entity`, `start_date`, `end_date` (`yyyy-mm-dd`) y `current`. |
| `contracts[]` | Contratos vigentes: `entity`, `object`, `start_date`, `end_date`, `amount` (COP) y `amount_text`. |
| `salary_scale[]` | La escala salarial de la entidad (`salary_scale_entity`): `level`, `denomination`, `grade`, `total` (COP mensual). |

> [!NOTE]
>
> Un id que el directorio no tiene devuelve `found: false` con HTTP 200.

## Buscar entidades

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

| Campo | Tipo | Notas |
| - | - | - |
| `query` | string | Palabras opcionales del nombre de la entidad. Vacío lista todas las entidades. |
| `department` | string | Departamento opcional. Se ignoran tildes, mayúsculas y puntuación. |
| `municipality` | string | Municipio opcional. Se ignoran tildes, mayúsculas y puntuación. |
| `order` | enum | Opcional: `nacional` o `territorial`. |
| `page` | integer | Número de página, empieza en 1. Por defecto `1`. |
| `per_page` | integer | Resultados por página (1-100). Por defecto `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" }'
```

Devuelve los filtros aplicados, `total`, `total_pages`, `page`, `per_page`, `count` y `results[]`. Cada entidad incluye `entity_id`, `sigep_code`, `name`, `nit` y `verification_digit`, `status`, `entity_type`, `order` y `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` y `longitude`.

## Una entidad

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

| Campo | Tipo | Notas |
| - | - | - |
| `entity_id` | integer | **Obligatorio.** El `entity_id` de SIGEP II Entities Search, p. ej. `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 }'
```

Devuelve `found`, `entity_id` y `entity`. Cada entidad incluye `entity_id`, `sigep_code`, `name`, `nit` y `verification_digit`, `status`, `entity_type`, `order` y `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` y `longitude`. Además trae `career_systems[]` (`code`, `name`), `salary_regimes[]` y `employment_natures[]`.

> [!NOTE]
>
> Un id que el directorio no tiene devuelve `found: false` con HTTP 200.

> [card] [Referencia completa](https://docs.usecroma.com/es/api-reference/overview.md)
>
> Esquemas, todos los campos de respuesta y un playground interactivo.


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