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

# Autocompletar afiliaciones

> Devuelve hasta 5 sugerencias de afiliaciones (instituciones, grupos, departamentos o facultades) cuyo nombre comience con el texto indicado.

## Parámetros de ruta

**aff\_type** `string` *required*

Subtipo de afiliación. Valores permitidos:

| Valor | Descripción | Ejemplo de ruta |
| - | - | - |
| `institution` | Instituciones (universidades, centros de investigación) | `/completer/affiliations/institution/univ` |
| `group` | Grupos de investigación | `/completer/affiliations/group/bio` |
| `department` | Departamentos académicos | `/completer/affiliations/department/ing` |
| `faculty` | Facultades | `/completer/affiliations/faculty/med` |

**text** `string` *required*

Prefijo del nombre de la afiliación. Ejemplo: `univ` devuelve afiliaciones
cuyo nombre comienza con "univ".

> [!NOTE]
>
> La búsqueda usa Elasticsearch y coincide por **prefijo**. Siempre devuelve un
> máximo de 5 resultados.

## Respuesta

Array de hasta 5 objetos con los siguientes campos:

**\[]** `object[]`

Lista de sugerencias.

**propiedades de cada sugerencia**

**\_id** `string`

Identificador de la afiliación en la base de datos.

**name** `string`

Nombre de la afiliación (variante más larga disponible).

**text** `string`

Texto utilizado por Elasticsearch para la sugerencia.

**\_score** `number`

Puntuación de relevancia de Elasticsearch.

**\_source** `object`

Documento interno de Elasticsearch. Contiene `name` (objeto con campo
`input`), `full_name`, `country_code` y `types`.

```json 200 — institution theme={null}
[
  {
    "_id": "03bp5hc83",
    "_index": "kahi_dev_institution",
    "_score": 10.0,
    "name": "Universidad de Antioquia",
    "text": "UdeA",
    "_source": {
      "full_name": "Universidad de Antioquia",
      "name": { "input": ["Universidad"], "weight": 10 },
      "country_code": "CO",
      "types": [{ "source": "ror", "type": "Education" }]
    }
  }
]
```

```json 200 — group theme={null}
[
  {
    "_id": "COL0000000",
    "_index": "kahi_dev_group",
    "_score": 10.0,
    "name": "Grupo de Biología Molecular",
    "text": "Biologia Molecular",
    "_source": {
      "name": { "input": ["Biologia Molecular"], "weight": 10 }
    }
  }
]
```

```json 400 theme={null}
{ "error": "mensaje de error" }
```


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