---
title: "Perfil de político"
method: GET
path: "/v1/politicos/{slug}"
tags: ["Políticos"]
---

# Perfil de político

`GET /v1/politicos/{slug}`

## Request

- Base URL: `https://api.alfil.co`
- URL: `https://api.alfil.co/v1/politicos/{slug}`
- Auth: OAuth 2 (authorization code, authorization URL `https://api.alfil.co/oauth/authorize`, token URL `https://api.alfil.co/oauth/token`, scopes: `buscar:read`)

Incluye cédula + cedula_fuente si hay participación política pública (ADR-020).

## Path parameters

- `slug` string, required

## Response `200`

Perfil del político

- union: Perfil de político (sin datos de contacto semiprivados)
  - object
    - `slug` string, required
    - `nombre` string, required
    - `partido` string, nullable, required
    - `trayectoria` Cargo[], required
      - `titulo` string, required
      - `desde` string, nullable, required
      - `hasta` string, nullable, required
      - `fuente` string
    - `sanciones` union, required
      - object
        - `estado_fuente` 'no_consultado', required
        - `registros` unknown, required
        - `fuente` string, required
        - `corte` unknown, required
        - `consultado_en` unknown, required
        - `error` unknown, required
      - object
        - `estado_fuente` 'ok', required
        - `registros` Sancion[], required
          - `tipo` string, required
          - `estado` 'vigente' | 'historica', required
          - `fecha` string, nullable, required
          - `fuente` string, required
          - `verificado` string: Fecha de última verificación
        - `fuente` string, required
        - `corte` string, required
        - `consultado_en` string, required
        - `error` unknown, required
      - object
        - `estado_fuente` 'error', required
        - `registros` unknown, required
        - `fuente` string, required
        - `corte` unknown, required
        - `consultado_en` string, required
        - `error` object, required
          - `codigo` 'FUENTE_NO_DISPONIBLE', required
          - `mensaje` 'No se pudo consultar en este momento', required
    - `responsabilidad_fiscal` union, required
      - object
        - `estado_fuente` 'no_consultado', required
        - `registros` unknown, required
        - `fuente` string, required
        - `corte` unknown, required
        - `consultado_en` unknown, required
        - `error` unknown, required
      - object
        - `estado_fuente` 'ok', required
        - `registros` ResponsabilidadFiscal[], required
          - `entidad` string, required
          - `tipo_sancion` string, required
          - `tema` string, nullable, required
          - `fecha_resolucion` string, nullable, required
          - `monto` string, nullable, required
          - `estado` 'ACTIVA' | 'ARCHIVADA' | 'NO_DETERMINADA', required
        - `fuente` string, required
        - `corte` string, required
        - `consultado_en` string, required
        - `error` unknown, required
      - object
        - `estado_fuente` 'error', required
        - `registros` unknown, required
        - `fuente` string, required
        - `corte` unknown, required
        - `consultado_en` string, required
        - `error` object, required
          - `codigo` 'FUENTE_NO_DISPONIBLE', required
          - `mensaje` 'No se pudo consultar en este momento', required
    - `fuente` Fuente, required: Proveniencia: fuente oficial y fecha de corte (atribución Ley 1712)
      - `nombre` string, required: Fuente oficial del dato
      - `url` string: URL de la fuente oficial
      - `corte` string, required: Fecha de corte del dato (ISO 8601)
      - `licencia` string: Licencia de la fuente
    - `referencias` Referencia[], required
      - `tipo` 'pagina_alfil' | 'registro_oficial' | 'documento_oficial' | 'coleccion_oficial', required
      - `titulo` string, required
      - `url` string, uri, required
      - `proveedor` string, required
      - `id_externo` string
    - `cedula` string, required: Presente con participación política pública; dato público (T-254/24)
    - `cedula_fuente` string, required: Fuente de la cédula (trazabilidad)
  - object
    - `slug` string, required
    - `nombre` string, required
    - `partido` string, nullable, required
    - `trayectoria` Cargo[], required
      - `titulo` string, required
      - `desde` string, nullable, required
      - `hasta` string, nullable, required
      - `fuente` string
    - `sanciones` union, required
      - object
        - `estado_fuente` 'no_consultado', required
        - `registros` unknown, required
        - `fuente` string, required
        - `corte` unknown, required
        - `consultado_en` unknown, required
        - `error` unknown, required
      - object
        - `estado_fuente` 'ok', required
        - `registros` Sancion[], required
          - `tipo` string, required
          - `estado` 'vigente' | 'historica', required
          - `fecha` string, nullable, required
          - `fuente` string, required
          - `verificado` string: Fecha de última verificación
        - `fuente` string, required
        - `corte` string, required
        - `consultado_en` string, required
        - `error` unknown, required
      - object
        - `estado_fuente` 'error', required
        - `registros` unknown, required
        - `fuente` string, required
        - `corte` unknown, required
        - `consultado_en` string, required
        - `error` object, required
          - `codigo` 'FUENTE_NO_DISPONIBLE', required
          - `mensaje` 'No se pudo consultar en este momento', required
    - `responsabilidad_fiscal` union, required
      - object
        - `estado_fuente` 'no_consultado', required
        - `registros` unknown, required
        - `fuente` string, required
        - `corte` unknown, required
        - `consultado_en` unknown, required
        - `error` unknown, required
      - object
        - `estado_fuente` 'ok', required
        - `registros` ResponsabilidadFiscal[], required
          - `entidad` string, required
          - `tipo_sancion` string, required
          - `tema` string, nullable, required
          - `fecha_resolucion` string, nullable, required
          - `monto` string, nullable, required
          - `estado` 'ACTIVA' | 'ARCHIVADA' | 'NO_DETERMINADA', required
        - `fuente` string, required
        - `corte` string, required
        - `consultado_en` string, required
        - `error` unknown, required
      - object
        - `estado_fuente` 'error', required
        - `registros` unknown, required
        - `fuente` string, required
        - `corte` unknown, required
        - `consultado_en` string, required
        - `error` object, required
          - `codigo` 'FUENTE_NO_DISPONIBLE', required
          - `mensaje` 'No se pudo consultar en este momento', required
    - `fuente` Fuente, required: Proveniencia: fuente oficial y fecha de corte (atribución Ley 1712)
      - `nombre` string, required: Fuente oficial del dato
      - `url` string: URL de la fuente oficial
      - `corte` string, required: Fecha de corte del dato (ISO 8601)
      - `licencia` string: Licencia de la fuente
    - `referencias` Referencia[], required
      - `tipo` 'pagina_alfil' | 'registro_oficial' | 'documento_oficial' | 'coleccion_oficial', required
      - `titulo` string, required
      - `url` string, uri, required
      - `proveedor` string, required
      - `id_externo` string
    - `cedula` unknown, required
    - `cedula_fuente` unknown, required

## Other responses

- `401`: Token faltante, expirado o de emisor inesperado
- `403`: Scope insuficiente
- `429`: Cuota agotada o rate limit

---

[API](https://skmtc.dev/alfil/apis/alfil-api.md) · [All operations](https://skmtc.dev/alfil/apis/alfil-api/llms.txt) · [OpenAPI document](https://skmtc.dev/alfil/apis/alfil-api/revisions/e2545a4c45a5?raw)