> ## 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
> As estatísticas macroeconômicas e financeiras oficiais da Colômbia: cerca de 850 séries, da TRM e da taxa de política monetária às taxas de crédito, à inflação, ao desemprego e ao PIB, que se buscam por nome ou periodicidade e se leem em qualquer intervalo de datas.
O Banco de la República é o banco central da Colômbia. Publica as estatísticas macroeconômicas e financeiras oficiais do país: a taxa representativa do mercado (TRM), a taxa de política monetária, a IBR, a DTF e as taxas de captação, as taxas de crédito por modalidade (consumo, habitação, comercial, microcrédito), os agregados de crédito e monetários, o índice de preços ao consumidor, o desemprego, o PIB, o balanço de pagamentos, as remessas e a atividade regional. Algumas séries ele produz; outras republica do DANE, da Superintendencia Financiera ou do Ministério da Fazenda, e cada uma diz de onde vêm.
Cerca de 850 séries, cada uma com sua história completa: preços ao consumidor desde 1954, a TRM desde 1991, a taxa de política monetária desde 1998, as taxas de crédito desde 2002. Cada série diz também quando foi atualizada pela última vez e quando vence a próxima atualização.
Busque no catálogo por nome, tema ou periodicidade e depois leia as observações de uma série pelo seu código, em qualquer intervalo de datas.
A fonte inteira, organizada e pronta para consultar: cada endpoint desta página responde em milissegundos. Cada resposta traz `as_of`: o quão atuais são os dados. [Como funcionam os datasets](/pt/datasets).
## Buscar séries
`POST /co/banrep/series-search/v1` Dataset
Uma única busca sobre cada série que o Banco de la República publica, por nome, tema ou periodicidade.
| Campo | Tipo | Notas |
| - | - | - |
| `query` | string | Palavras opcionais buscadas no nome, na descrição, nas palavras-chave e nas categorias da série, p. ex. `TRM`, `tasa de política monetaria`, `crédito de consumo` ou `desempleo`. |
| `frequency` | enum | Periodicidade opcional: `daily` (diária), `weekly` (semanal), `monthly` (mensal), `quarterly` (trimestral), `semiannual` (semestral) ou `annual` (anual). |
| `page` | integer | Número da página, começa em 1. Por padrão `1`. |
| `per_page` | integer | Resultados por página (1-100). Por padrão `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" }'
```
Retorna `as_of` (o quão atuais são os dados), os filtros aplicados, `total` e `total_is_exact`, `page`, `per_page`, `total_pages`, `count` e `results[]`, da melhor correspondência à pior (sem busca, da observação mais recente à mais antiga). Cada série traz `id` (seu código, o que `series_code` recebe), `name`, `description`, `category`, `subcategory` e `topic`, `frequency` (`daily`, `weekly`, `monthly`, `quarterly`, `semiannual` ou `annual`), `unit` e `unit_symbol`, `source` (quem produz o dado, p. ex. `Banco de la República` ou `DANE`), `produced_by_banrep`, `geography`, `seasonal_adjustment`, `base_period`, `prices`, `decimals`, `definition`, `methodology_url`, `first_date` e `last_date` (a primeira e a última observação), `last_load_date` (quando o Banco de la República a atualizou pela última vez) e `next_load_date` (quando planeja atualizá-la de novo; null para uma série descontinuada).
Alguns códigos úteis: `1` TRM, `59` taxa de política monetária, `15126` taxa de crédito ao consumo (mensal), `15000` índice de preços ao consumidor, `15312` taxa de desemprego nacional, `15154` PIB real trimestral.
## Uma série
`POST /co/banrep/series/v1` Dataset
As observações de uma série pelo seu código, em toda a sua história ou em um intervalo de datas.
| Campo | Tipo | Notas |
| - | - | - |
| `series_code` | string | **Obrigatório.** O código da série, o `id` de um resultado de busca, p. ex. `1` (TRM) ou `59` (taxa de política monetária). |
| `from_date` | string | Opcional: só observações nesta data ou depois, `yyyy-mm-dd`. |
| `to_date` | string | Opcional: só observações nesta data ou 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"
}'
```
Retorna `as_of`, `found`, `series_code`, `from_date`, `to_date`, `series`, `count` e `observations[]` (`date` e `value`, da mais antiga à mais recente). A `date` de um valor mensal, trimestral ou anual é o último dia do seu período. As séries diárias trazem cada dia do calendário, fins de semana e feriados incluídos, com o valor vigente nesse dia, e podem ir alguns dias à frente quando um valor é fixado com antecedência. Cada série traz `id` (seu código, o que `series_code` recebe), `name`, `description`, `category`, `subcategory` e `topic`, `frequency` (`daily`, `weekly`, `monthly`, `quarterly`, `semiannual` ou `annual`), `unit` e `unit_symbol`, `source` (quem produz o dado, p. ex. `Banco de la República` ou `DANE`), `produced_by_banrep`, `geography`, `seasonal_adjustment`, `base_period`, `prices`, `decimals`, `definition`, `methodology_url`, `first_date` e `last_date` (a primeira e a última observação), `last_load_date` (quando o Banco de la República a atualizou pela última vez) e `next_load_date` (quando planeja atualizá-la de novo; null para uma série descontinuada).
Um código sob o qual o Banco de la República não publica nenhuma série retorna `found: false` com HTTP 200, não um erro.
Esquemas, todos os campos de resposta e um playground interativo.
This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.