> ## 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 entidad geográfica

> Devuelve una entidad geográfica (departamento o ciudad) a partir de su código DANE.

## Parámetros de ruta

**geo\_type** `string` *required*

Tipo de entidad geográfica. Valores permitidos: `state` (departamento) o `city` (ciudad).

**geo\_id** `string` *required*

Código DANE de la entidad. Ejemplos: `05` para Antioquia (state), `05001`
para Medellín (city).

No recibe parámetros de consulta: `view` no aplica a las entidades geográficas.

## Respuesta

**data** `object`

La entidad geográfica solicitada.

**propiedades**

**id** `string`

Código DANE de la entidad.

**name** `string`

Nombre de la entidad.

**type** `string`

Tipo: `state` o `city`.

**country** `string`

País al que pertenece.

**country\_code** `string`

Código ISO 3166-1 alpha-2 del país.

**state** `object | null`

Departamento al que pertenece la ciudad (`id`, `name`). Solo presente
cuando `geo_type` es `city`.

**latitude** `number | null`

Latitud. Solo presente cuando `geo_type` es `city`.

**longitude** `number | null`

Longitud. Solo presente cuando `geo_type` es `city`.

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

Identificadores externos (`id`, `source`). Por ejemplo, el código DANE.

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

Citas totales de los productos asociados, por fuente (`count`, `source`).

**products\_count** `integer`

Número de productos bibliográficos asociados.

**authors\_count** `integer`

Número de autores asociados.

**institutions\_count** `integer`

Número de instituciones asociadas.

**groups\_count** `integer`

Número de grupos de investigación asociados.

**cities\_count** `integer | null`

Número de ciudades asociadas. Solo presente cuando `geo_type` es `state`.

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

Las instituciones, los grupos y, en los departamentos, las ciudades se consultan en [Afiliaciones de una entidad geográfica](https://help.impactu.colav.co/api-reference/geo/get-geo-affiliations.md).

```json 200 — Departamento theme={null}
{
  "data": {
    "authors_count": 43836,
    "citations_count": [{"count": 1172650, "source": "openalex"}],
    "cities_count": 22,
    "country": "Colombia",
    "country_code": "CO",
    "external_ids": [{"id": "05", "source": "dane"}],
    "groups_count": 1117,
    "id": "05",
    "institutions_count": 178,
    "name": "Antioquia",
    "products_count": 295187,
    "type": "state"
  },
  "meta": {"count": 1, "cursor": {"next": null, "previous": null}, "db_response_time_ms": 25, "page": 1, "size": 1}
}
```

```json 200 — Ciudad theme={null}
{
  "data": {
    "authors_count": 40431,
    "citations_count": [{"count": 1103485, "source": "openalex"}],
    "country": "Colombia",
    "country_code": "CO",
    "external_ids": [{"id": "05001", "source": "dane"}],
    "groups_count": 1020,
    "id": "05001",
    "institutions_count": 131,
    "latitude": 6.246631,
    "longitude": -75.581775,
    "name": "Medellín",
    "products_count": 275779,
    "state": {"id": "05", "name": "Antioquia"},
    "type": "city"
  },
  "meta": {"count": 1, "cursor": {"next": null, "previous": null}, "db_response_time_ms": 25, "page": 1, "size": 1}
}
```

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


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