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

# Afiliaciones relacionadas

> Devuelve las facultades, departamentos, grupos y autores asociados a una afiliación.

## Parámetros de ruta

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

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

**affiliation\_id** `string` *required*

Identificador de la afiliación. Ejemplos: `03bp5hc83` (institución),
`03bp5hc83_2` (facultad), `03bp5hc83_2_21620001_3153` (departamento),
`COL0000407` (grupo).

> [!NOTE]
>
> Este endpoint no recibe parámetros de consulta. A diferencia de [Obtener una
> afiliación](https://help.impactu.colav.co/api-reference/affiliation/get-affiliation.md), la respuesta no está
> envuelta en `data`.

## Respuesta

La respuesta es un objeto cuyas listas dependen del tipo de afiliación consultada:

| `affiliation_type` | `faculties` | `departments` | `groups` | `authors` |
| - | :-: | :-: | :-: | :-: |
| `institution` | ✅ | ✅ | ✅ | |
| `faculty` | | ✅ | ✅ | ✅ |
| `department` | | | ✅ | ✅ |
| `group` | | | | ✅ |

Una institución sin facultades ni departamentos también incluye `authors`. Si la afiliación no existe, o el tipo no es uno de los cuatro, la respuesta es `200` con las listas vacías.

**faculties** `object[]`

Facultades de la institución.

**propiedades**

**id** `string`

Identificador de la facultad.

**name** `string`

Nombre.

**departments** `object[]`

Departamentos. Misma estructura que `faculties`.

**groups** `object[]`

Grupos de investigación. Misma estructura que `faculties`.

**authors** `object[]`

Autores asociados.

**propiedades**

**id** `string`

Identificador del autor.

**full\_name** `string`

Nombre completo.

```json 200 — Institución theme={null}
{
  "faculties": [{"id": "example-institution-id_2", "name": "Facultad Ejemplo"}],
  "departments": [{"id": "example-institution-id_2_21620001_3153", "name": "Departamento Ejemplo"}],
  "groups": [{"id": "COL0000001", "name": "Grupo de Investigación Ejemplo"}]
}
```

```json 200 — Facultad theme={null}
{
  "departments": [{"id": "example-institution-id_20_22020002_3131", "name": "Departamento Ejemplo"}],
  "groups": [{"id": "COL0000001", "name": "Grupo de Investigación Ejemplo"}],
  "authors": [{"id": "0000000001", "full_name": "María Ejemplo García"}]
}
```

```json 200 — Departamento theme={null}
{
  "groups": [{"id": "COL0000001", "name": "Grupo de Investigación Ejemplo"}],
  "authors": [{"id": "0000000001", "full_name": "María Ejemplo García"}]
}
```

```json 200 — Grupo theme={null}
{"authors": [{"id": "0000000001", "full_name": "María Ejemplo García"}]}
```


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