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

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.

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

Campo	Tipo	Notas
`servant_id`	string	Obligatorio. El `id` de SIGEP II People Search, p. ej. `S2060152-4395-4`.

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

Un id que el directorio no tiene devuelve found: false con HTTP 200.

Buscar entidades

POST /co/sigep/entities-search/v1 Live

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

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

Campo	Tipo	Notas
`entity_id`	integer	Obligatorio. El `entity_id` de SIGEP II Entities Search, p. ej. `3098`.

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[].

Un id que el directorio no tiene devuelve found: false con HTTP 200.

Referencia completa

Esquemas, todos los campos de respuesta y un playground interactivo.

Primeros pasos

Tipos de solicitud

Monitores

Comentarios

Países

Buscar personas

Una hoja de vida

Buscar entidades

Una entidad

Referencia completa

​Buscar personas

​Una hoja de vida

​Buscar entidades

​Una entidad

Referencia completa

Buscar personas

Una hoja de vida

Buscar entidades

Una entidad