> ## Documentation Index
> Fetch the complete documentation index at: https://help.impactu.colav.co/llms.txt
> Use this file to discover all available pages before exploring further.

# Filtros disponibles de afiliaciones

> Opciones disponibles para filtrar la búsqueda de afiliaciones, con su cantidad de resultados.

Devuelve los valores que puedes usar en los filtros de [Buscar afiliaciones](https://help.impactu.colav.co/api-reference/search/affiliations.md).
Las opciones y sus conteos dependen de los criterios que envíes: solo se devuelven las que existen dentro de ese resultado.

## Parámetros de ruta

**affiliation\_type** `string` *required*

Tipo de afiliación: `institution`, `faculty`, `department` o `group`.

## Parámetros de consulta

Todos son opcionales.

**keywords** `string`

Texto de búsqueda (nombre de la afiliación).

**states** `string`

Departamentos. Acepta varios valores separados por coma. Ejemplo:
`Antioquia,Tolima`.

**cities** `string`

Ciudades. Acepta varios valores separados por coma. Ejemplo: `Bogotá,Cali`.

**groups\_ranking** `string`

Clasificación vigente del grupo. Acepta varios valores separados por coma.
Ejemplo: `A1,A2`.

## Respuesta

Todos los campos son listas de opciones con la misma estructura:

**states** `object[]`

Departamentos disponibles.

**propiedades de cada opción**

**value** `string`

Valor para enviar en el filtro.

**label** `string`

Nombre normalizado para mostrar.

**count** `integer`

Cantidad de afiliaciones asociadas.

**cities** `object[]`

Ciudades disponibles. Misma estructura que `states`.

**groups\_ranking** `object[]`

Clasificaciones vigentes de los grupos (por ejemplo, `A1`, `A`, `B`, `C`).
Misma estructura que `states`. Solo se devuelve con `affiliation_type=group`.

```json 200 — Institución theme={null}
{
  "cities": [{"count": 907, "label": "Londres", "value": "Londres"}],
  "states": [{"count": 2640, "label": "England", "value": "England"}]
}
```

```json 200 — Grupo theme={null}
{
  "cities": [{"count": 2483, "label": "Bogotá", "value": "Bogotá"}],
  "groups_ranking": [{"count": 2732, "label": "C", "value": "C"}],
  "states": [{"count": 2135, "label": "Bogotá", "value": "Bogotá"}]
}
```

```json 400 theme={null}
{
  "error": "1 validation error for QueryParams\nmax\n  Input should be greater than or equal to 1 [type=greater_than_equal, input_value='0', input_type=str]\n    For further i…"
}
```


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