> ## Documentation Index
> Fetch the complete documentation index at: https://docs.usecroma.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Banco de la República

> Las estadísticas macroeconómicas y financieras oficiales de Colombia: cerca de 850 series, desde la TRM y la tasa de política monetaria hasta las tasas de colocación, la inflación, el desempleo y el PIB, que se buscan por nombre o periodicidad y se leen en cualquier rango de fechas.

El Banco de la República es el banco central de Colombia. Publica las estadísticas macroeconómicas y financieras oficiales del país: la tasa representativa del mercado (TRM), la tasa de política monetaria, la IBR, la DTF y las tasas de captación, las tasas de colocación por modalidad (consumo, vivienda, comercial, microcrédito), los agregados crediticios y monetarios, el índice de precios al consumidor, el desempleo, el PIB, la balanza de pagos, las remesas y la actividad regional. Algunas series las produce él mismo; otras las republica del DANE, la Superintendencia Financiera o el Ministerio de Hacienda, y cada una dice de dónde vienen.

Cerca de 850 series, cada una con su historia completa: precios al consumidor desde 1954, la TRM desde 1991, la tasa de política monetaria desde 1998, las tasas de colocación desde 2002. Cada serie dice además cuándo se actualizó por última vez y cuándo le toca la próxima actualización.

Busca en el catálogo por nombre, tema o periodicidad y luego lee las observaciones de una serie por su código, en cualquier rango de fechas.

<Note>
  La fuente entera, organizada y lista para consultar: cada endpoint de esta página responde en milisegundos. Cada respuesta incluye `as_of`: qué tan actualizados están los datos. [Cómo funcionan los datasets](/es/datasets).
</Note>

## Buscar series

`POST /co/banrep/series-search/v1` <a className="dataset-pill" href="/es/datasets">Dataset</a>

Una sola búsqueda sobre cada serie que publica el Banco de la República, por nombre, tema o periodicidad.

| Campo | Tipo | Notas |
| - | - | - |
| `query` | string | Palabras opcionales que se buscan en el nombre, la descripción, las palabras clave y las categorías de la serie, p. ej. `TRM`, `tasa de política monetaria`, `crédito de consumo` o `desempleo`. |
| `frequency` | enum | Periodicidad opcional: `daily` (diaria), `weekly` (semanal), `monthly` (mensual), `quarterly` (trimestral), `semiannual` (semestral) o `annual` (anual). |
| `page` | integer | Número de página, empieza en 1. Por defecto `1`. |
| `per_page` | integer | Resultados por página (1-100). Por defecto `20`. |

```bash theme={"dark"}
curl https://api.croma.run/co/banrep/series-search/v1 \
  -H "Authorization: Bearer $CROMA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "query": "crédito de consumo", "frequency": "monthly" }'
```

Devuelve `as_of` (qué tan actualizados están los datos), los filtros aplicados, `total` y `total_is_exact`, `page`, `per_page`, `total_pages`, `count` y `results[]`, de la mejor coincidencia a la peor (sin búsqueda, de la observación más reciente a la más antigua). Cada serie incluye `id` (su código, el que recibe `series_code`), `name`, `description`, `category`, `subcategory` y `topic`, `frequency` (`daily`, `weekly`, `monthly`, `quarterly`, `semiannual` o `annual`), `unit` y `unit_symbol`, `source` (quién produce el dato, p. ej. `Banco de la República` o `DANE`), `produced_by_banrep`, `geography`, `seasonal_adjustment`, `base_period`, `prices`, `decimals`, `definition`, `methodology_url`, `first_date` y `last_date` (la primera y la última observación), `last_load_date` (cuándo la actualizó el Banco de la República por última vez) y `next_load_date` (cuándo planea hacerlo de nuevo; null para una serie descontinuada).

Algunos códigos útiles: `1` TRM, `59` tasa de política monetaria, `15126` tasa de crédito de consumo (mensual), `15000` índice de precios al consumidor, `15312` tasa de desempleo nacional, `15154` PIB real trimestral.

## Una serie

`POST /co/banrep/series/v1` <a className="dataset-pill" href="/es/datasets">Dataset</a>

Las observaciones de una serie por su código, en toda su historia o en un rango de fechas.

| Campo | Tipo | Notas |
| - | - | - |
| `series_code` | string | **Obligatorio.** El código de la serie, el `id` de un resultado de búsqueda, p. ej. `1` (TRM) o `59` (tasa de política monetaria). |
| `from_date` | string | Opcional: solo observaciones en esta fecha o después, `yyyy-mm-dd`. |
| `to_date` | string | Opcional: solo observaciones en esta fecha o antes, `yyyy-mm-dd`. |

```bash theme={"dark"}
curl https://api.croma.run/co/banrep/series/v1 \
  -H "Authorization: Bearer $CROMA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
        "series_code": "1",
        "from_date": "2026-09-01",
        "to_date": "2026-09-30"
      }'
```

Devuelve `as_of`, `found`, `series_code`, `from_date`, `to_date`, `series`, `count` y `observations[]` (`date` y `value`, de la más antigua a la más reciente). La `date` de un valor mensual, trimestral o anual es el último día de su periodo. Las series diarias traen cada día calendario, fines de semana y festivos incluidos, con el valor vigente ese día, y pueden ir unos días adelante cuando un valor se fija por anticipado. Cada serie incluye `id` (su código, el que recibe `series_code`), `name`, `description`, `category`, `subcategory` y `topic`, `frequency` (`daily`, `weekly`, `monthly`, `quarterly`, `semiannual` o `annual`), `unit` y `unit_symbol`, `source` (quién produce el dato, p. ej. `Banco de la República` o `DANE`), `produced_by_banrep`, `geography`, `seasonal_adjustment`, `base_period`, `prices`, `decimals`, `definition`, `methodology_url`, `first_date` y `last_date` (la primera y la última observación), `last_load_date` (cuándo la actualizó el Banco de la República por última vez) y `next_load_date` (cuándo planea hacerlo de nuevo; null para una serie descontinuada).

<Note>
  Un código bajo el cual el Banco de la República no publica ninguna serie devuelve `found: false` con HTTP 200, no un error.
</Note>

<Card title="Referencia completa" icon="code" href="/es/api-reference/overview">
  Esquemas, todos los campos de respuesta y un playground interactivo.
</Card>


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