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

# Obtener una afiliación

> Devuelve una afiliación (institución, facultad, departamento o grupo) a partir de su identificador.

## 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_20` (facultad), `03bp5hc83_2_21620003_3154` (departamento),
`COL0001262` (grupo).

## Parámetros de consulta

**view** `string` (default: full)

Nivel de detalle de la respuesta. `full` devuelve todos los campos. `summary`
devuelve solo los campos principales de la entidad y, en productos, patentes y
proyectos, recorta la lista de autores a 10. Otro valor responde `400`.

`max`, `page` y `sort` no aplican.

> [!NOTE]
>
> La API no valida `affiliation_type`: devuelve la afiliación que corresponde a
> `affiliation_id` con cualquier tipo, aunque no coincida o no exista. Por
> ejemplo, `/affiliation/faculty/03bp5hc83` devuelve la institución, sin error.
> Usa el tipo correcto: de él dependen las afiliaciones superiores que se
> incluyen en `affiliations`.

## Respuesta

**data** `object`

La afiliación solicitada.

**propiedades**

**\_id** `string`

Identificador de la afiliación.

**name** `string | null`

Nombre principal (en español si existe).

**names** `object[]`

Nombres por fuente (`name`, `lang`, `source`, `provenance`).

**abbreviations** `string[]`

Siglas y nombres cortos.

**aliases** `string[]`

Nombres alternos.

**types** `object[]`

Tipos de la afiliación por fuente (`type`, `source`, `provenance`).

**addresses** `object[]`

Direcciones: `city`, `state`, `country`, `country_code`, `postcode`,
`lat`, `lng`.

**year\_established** `integer | null`

Año de fundación.

**description** `object[]`

Descripciones por fuente. En los grupos incluye textos como estado del
arte, objetivos, plan de trabajo, producción destacada, retos y visión.

**products\_count** `integer`

Cantidad de productos.

**citations\_count** `object[]`

Citas por fuente (`count`, `source`, `provenance`).

**h\_index** `integer | null`

Índice h.

**h5\_index** `integer | null`

Índice h de los últimos 5 años.

**ranking** `object[]`

Clasificaciones, por ejemplo la de un grupo (`rank`, `source`,
`from_date`, `to_date`).

**affiliations** `object[]`

Afiliaciones superiores directas (por ejemplo, la institución de una
facultad).

**relations** `object[]`

Afiliaciones relacionadas: las superiores y, en facultades, también sus
departamentos y dependencias (`id`, `name`, `types`, `external_urls`).

**subjects** `object[]`

Áreas de conocimiento agrupadas por fuente (por ejemplo, OCDE en los
grupos).

**status** `array`

Estado. Puede ser una lista de textos (instituciones) o de objetos
`source` y `status` (grupos).

**external\_ids** `object[]`

Identificadores externos (ROR, OpenAlex, SNIES, Scienti, Minciencias,
entre otros).

**external\_urls** `object[]`

Enlaces externos (sitio web, Wikipedia, OpenAlex, ROR).

**updated** `object[]`

Última actualización por fuente (`source`, `time` en segundos Unix).

**meta** `object`

Metadatos de la consulta, con la misma forma que en los listados: `count` y
`size` valen `1`, `page` vale `1`, `cursor.next` y `cursor.previous` son
`null`, y `db_response_time_ms` es el tiempo de respuesta de la base de datos.

El identificador llega en `_id`, no en `id` como en las demás entidades. Con `view=summary` se omiten los campos sin dato.

### Diferencias según el tipo

| Campo | Institución | Facultad | Departamento | Grupo |
| - | - | - | - | - |
| `affiliations` | vacío | la institución | la institución y la facultad | la institución |
| `relations` | vacío | institución y departamentos | institución y facultad | institución |
| `description` | vacío | vacío | vacío | textos del grupo |
| `ranking` | sin datos útiles | vacío | vacío | clasificación del grupo |

```json 200 — Institución theme={null}
{
  "data": {
    "_id": "example-institution-id",
    "abbreviations": ["UE"],
    "addresses": [
      {
        "city": "Medellín",
        "country": "Colombia",
        "country_code": "CO",
        "lat": 6.25184,
        "lng": -75.56359,
        "postcode": "",
        "state": "Antioquia"
      }
    ],
    "affiliations": [],
    "aliases": [],
    "citations_count": [{"count": 610587, "provenance": null, "source": "scholar"}],
    "description": [],
    "external_ids": [{"id": "example-isni-id", "provenance": "ror", "source": "isni"}],
    "external_urls": [{"provenance": "scienti", "source": "site", "url": "https://www.example.edu.co"}],
    "h5_index": 100,
    "h_index": 242,
    "name": "Universidad Ejemplo",
    "names": [{"lang": "es", "name": "Universidad Ejemplo", "provenance": null, "source": "ror"}],
    "products_count": 135364,
    "ranking": [
      {
        "date": null,
        "from_date": null,
        "issn": null,
        "level": null,
        "order": null,
        "rank": null,
        "source": null,
        "to_date": null
      }
    ],
    "relations": [],
    "status": ["active"],
    "subjects": [],
    "types": [{"code": null, "level": null, "provenance": null, "source": "ror", "type": "education", "type_class": null}],
    "updated": [{"source": "ror", "time": 1789879321}],
    "year_established": 1803
  },
  "meta": {"count": 1, "cursor": {"next": null, "previous": null}, "db_response_time_ms": 25, "page": 1, "size": 1}
}
```

```json 200 — Facultad theme={null}
{
  "data": {
    "_id": "example-institution-id_20",
    "abbreviations": [],
    "addresses": [
      {
        "city": "Medellín",
        "country": "Colombia",
        "country_code": "CO",
        "lat": 6.25184,
        "lng": -75.56359,
        "postcode": "",
        "state": "Antioquia"
      }
    ],
    "affiliations": [
      {
        "external_urls": [{"provenance": "scienti", "source": "site", "url": "https://www.example.edu.co"}],
        "id": "example-institution-id",
        "name": "Universidad Ejemplo",
        "types": [{"code": null, "level": null, "provenance": null, "source": "ror", "type": "education", "type_class": null}]
      }
    ],
    "aliases": [],
    "citations_count": [{"count": 8658, "provenance": null, "source": "scholar"}],
    "description": [],
    "external_ids": [{"id": "example-staff-id", "provenance": null, "source": "staff"}],
    "external_urls": [],
    "h5_index": 12,
    "h_index": 31,
    "name": "Facultad Ejemplo",
    "names": [{"lang": "es", "name": "Facultad Ejemplo", "provenance": null, "source": "staff"}],
    "products_count": 6580,
    "ranking": [],
    "relations": [
      {
        "external_urls": [{"provenance": "scienti", "source": "site", "url": "https://www.example.edu.co"}],
        "id": "example-institution-id",
        "name": "Universidad Ejemplo",
        "types": [{"code": null, "level": null, "provenance": null, "source": "ror", "type": "education", "type_class": null}]
      }
    ],
    "status": [],
    "subjects": [],
    "types": [{"code": null, "level": null, "provenance": null, "source": "staff", "type": "faculty", "type_class": null}],
    "updated": [{"source": "staff", "time": 1789879630}],
    "year_established": null
  },
  "meta": {"count": 1, "cursor": {"next": null, "previous": null}, "db_response_time_ms": 25, "page": 1, "size": 1}
}
```

```json 200 — Departamento theme={null}
{
  "data": {
    "_id": "example-institution-id_2_example-staff-id",
    "abbreviations": [],
    "addresses": [
      {
        "city": "Medellín",
        "country": "Colombia",
        "country_code": "CO",
        "lat": 6.25184,
        "lng": -75.56359,
        "postcode": "",
        "state": "Antioquia"
      }
    ],
    "affiliations": [
      {
        "external_urls": [{"provenance": "scienti", "source": "site", "url": "https://www.example.edu.co"}],
        "id": "example-institution-id",
        "name": "Universidad Ejemplo",
        "types": [{"code": null, "level": null, "provenance": null, "source": "ror", "type": "education", "type_class": null}]
      }
    ],
    "aliases": [],
    "citations_count": [{"count": 28, "provenance": null, "source": "scholar"}],
    "description": [],
    "external_ids": [{"id": "example-staff-id", "provenance": null, "source": "staff"}],
    "external_urls": [],
    "h5_index": 4,
    "h_index": 4,
    "name": "Departamento Ejemplo",
    "names": [{"lang": "es", "name": "Departamento Ejemplo", "provenance": null, "source": "staff"}],
    "products_count": 761,
    "ranking": [],
    "relations": [
      {
        "external_urls": [{"provenance": "scienti", "source": "site", "url": "https://www.example.edu.co"}],
        "id": "example-institution-id",
        "name": "Universidad Ejemplo",
        "types": [{"code": null, "level": null, "provenance": null, "source": "ror", "type": "education", "type_class": null}]
      }
    ],
    "status": [],
    "subjects": [],
    "types": [{"code": null, "level": null, "provenance": null, "source": "staff", "type": "department", "type_class": null}],
    "updated": [{"source": "staff", "time": 1789879629}],
    "year_established": null
  },
  "meta": {"count": 1, "cursor": {"next": null, "previous": null}, "db_response_time_ms": 25, "page": 1, "size": 1}
}
```

```json 200 — Grupo theme={null}
{
  "data": {
    "_id": "COL0000001",
    "abbreviations": [],
    "addresses": [
      {
        "city": "Medellín",
        "country": "Colombia",
        "country_code": "CO",
        "lat": 6.25184,
        "lng": -75.56359,
        "postcode": "",
        "state": "Antioquia"
      }
    ],
    "affiliations": [
      {
        "external_urls": [{"provenance": "scienti", "source": "site", "url": "https://www.example.edu.co"}],
        "id": "example-institution-id",
        "name": "Universidad Ejemplo",
        "types": [{"code": null, "level": null, "provenance": null, "source": "ror", "type": "education", "type_class": null}]
      }
    ],
    "aliases": [],
    "citations_count": [{"count": 3928, "provenance": null, "source": "scholar"}],
    "description": [
      {
        "description": {
          "TXT_ESTADO_ARTE": "El grupo Centauro ha logrado un importante aporte en publicaciones y en resultados de investigación en sus diferentes líneas de investigación consolidadazas: 1)…",
          "TXT_OBJETIVOS": "El grupo Centauro tiene como objetivos los siguientes:\r\n\r\n1. Generar proyectos de investigación enfocados al avance del conocimiento científico y a la búsqueda …",
          "TXT_PLAN_TRABAJO": "El grupo Grupo de Investigación Ejemplo (Grupo de investigación en Ciencias Veterinarias), tiene como objetivo el apoyo al desarrollo científico y tecnológico y al avance de las Cien…",
          "TXT_PROD_DESTACADA": "1. Creación de dos líneas de maestría: una en Medicina Tropical y otra en Farmacología en la Corporación Ciencias Básicas Biomédicas, que cuenta ahora con un es…",
          "TXT_RETOS": "1. Consecución regular de recursos externos nacionales e internacionales para la financiación de proyectos de investigación en sus diferentes líneas y campos de…",
          "TXT_VISION": "Visión Centauro 2027\r\n\r\nPara el año 2027, el grupo Centauro será un grupo de referencia nacional e internacional en el campo de las Ciencias Veterinarias, en vi…"
        },
        "source": "scienti"
      }
    ],
    "external_ids": [{"id": "example-scienti-id", "provenance": null, "source": "scienti"}],
    "external_urls": [],
    "h5_index": 8,
    "h_index": 34,
    "name": "Grupo de Investigación Ejemplo",
    "names": [{"lang": "es", "name": "Grupo de Investigación Ejemplo", "provenance": null, "source": "scienti"}],
    "products_count": 800,
    "ranking": [
      {
        "date": null,
        "from_date": 1653368400,
        "issn": null,
        "level": null,
        "order": null,
        "rank": "A1",
        "source": "scienti",
        "to_date": 1716440400
      }
    ],
    "relations": [
      {
        "external_urls": [{"provenance": "scienti", "source": "site", "url": "https://www.example.edu.co"}],
        "id": "example-institution-id",
        "name": "Universidad Ejemplo",
        "types": [{"code": null, "level": null, "provenance": null, "source": "ror", "type": "education", "type_class": null}]
      }
    ],
    "status": [{"source": "minciencias", "status": "activo"}],
    "subjects": [
      {
        "provenance": null,
        "source": "OCDE",
        "subjects": [
          {
            "external_ids": [{"id": "4C01", "provenance": null, "source": "OCDE"}],
            "id": "",
            "level": 2,
            "name": "Ciencias Veterinarias"
          }
        ]
      }
    ],
    "types": [{"code": null, "level": null, "provenance": null, "source": "scienti", "type": "group", "type_class": null}],
    "updated": [{"source": "scienti", "time": 1789888124}],
    "year_established": 1997
  },
  "meta": {"count": 1, "cursor": {"next": null, "previous": null}, "db_response_time_ms": 25, "page": 1, "size": 1}
}
```

```json 404 theme={null}
{"error": "The affiliation with id 0000000000 does not exist."}
```


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