Public api that contains info about Colombia, departments, cities, tourists places and presidents
Public api that contains info about Colombia, departments, cities, tourists places and presidents
API Colombia is a public RESTful API that enables users to access a wide range of public information about the country of Colombia.
Official website: api-colombia.com
VitePress | Swagger | Ask AI about API-Colombia
Read this document in Español
Learn how to use API-Colombia with detailed videos that walk you through the API step by step:
▶️ Watch the API-Colombia video playlist on YouTube
api/Dockerfiledocs/DockerfileThe API also exposes a built-in Model Context Protocol server, so AI agents can consume the same public Colombia data without learning the REST surface by hand.
https://api-colombia.com/api/v1/mcp (Streamable HTTP, stateless, no auth, read-only).list_colombia_resources, get_api_reference), generic data tools (list_items, get_item_by_id, get_items_by_name, search_items, list_items_paged, get_country_info) that cover every resource, and relational tools (e.g. get_cities_by_department).colombia://catalog and per-table entries./mcp (locally https://localhost:7274/mcp) — list and call tools, browse resources, and send raw JSON-RPC, no install required.See the full guide in docs/mcp.md.
dotnet build command to generate the build of the project.The documentation site is built with VitePress and lives in the docs/ folder.
Prerequisites:
Setup:
cd docsnpm installLocal development:
npm run docs:dev
Starts the VitePress dev server with hot-reload.Build static site:
npm run docs:build
The generated site will be in docs/.vitepress/dist.Preview built site:
npm run docs:preview
Useful to simulate a production-like server locally.Note: Run all the commands above inside the docs/ directory.
Build the API Docker image from the api folder:
docker build -t apicolombia-api ./apiRun the API container:
docker run -p 80:80 apicolombia-apiBuild the docs Docker image from the docs folder:
docker build -t apicolombia-docs ./docsRun the docs container:
docker run -p 80:80 apicolombia-docsThe project includes comprehensive integration tests using xUnit and an in-memory database. The tests verify that all API endpoints work correctly.
To run all tests:
dotnet testTo run tests with coverage:
dotnet test /p:CollectCoverage=trueThe integration tests are located in the api.Tests project and use:
Each endpoint has corresponding integration tests that verify:
The test database is seeded with sample data for each entity type, ensuring consistent test results.
The public page api-colombia.com has useful information about the API and a brief description of the available endpoints and the same allows access to the endpoints described below.
| Repo | Url | Description |
|---|---|---|
| https://github.com/Mteheran/invasivespecie-colombia | https://especiesinvasoras.api-colombia.com/ | A portal to consult all invasive species in Colombia |
| https://github.com/lightbluetitan/colombiapi | https://github.com/lightbluetitan/colombiapi | ColombiaAPI for R, an R package that consumes the data exposed by api-colombia |
| https://github.com/JuanPabloDiaz/turismo | https://turismo.colombia.jpdiaz.dev | Interactive tourism map of Colombia showcasing tourist destinations across the country |
| https://github.com/JuanPabloDiaz/colombia | https://colombia.jpdiaz.dev | A web app that offers an interactive and comprehensive exploration of Colombia's geography, culture, biodiversity, and institutions through maps, multimedia, and detailed data from api-colombia.com |
| https://github.com/duvan-gallego/mcp-api-colombia | - | MCP (Model Context Protocol) server for API Colombia, enabling AI assistants to access Colombia data |
| https://github.com/crexative/colombia-mcp-server | - | Colombia MCP Server - Another MCP implementation for integrating API Colombia with AI tools |
| HTTP Verbs | Endpoints | Action |
|---|---|---|
| GET | /api/{version}/city | Get the list of all cities |
| GET | /api/{version}/city/{id} | Get the information of a city by it is id |
| GET | /api/{version}/city/name/{name} | Get the information of a city by it is name |
| GET | /api/{version}/city/search/{keyword} | Get the information of a city searching by keyword |
| GET | /api/{version}/city/pagedList | Get the list of all cities paginated |
| HTTP Verbs | Endpoints | Action |
|---|---|---|
| GET | /api/{version}/country/Colombia | Get the information of Colombia |
| HTTP Verbs | Endpoints | Action |
|---|---|---|
| GET | /api/{version}/Department | Get the list of all departments in Colombia |
| GET | /api/{version}/Department/{id} | Get the information of a department by it is id |
| GET | /api/{version}/Department/name/{name} | Get the information of a department by it is name |
| GET | /api/{version}/Department/search/{keyword} | Get the information of a department searching by keyword |
| GET | /api/{version}/Department/pagedList | Get the list of all department paginated |
| HTTP Verbs | Endpoints | Action |
|---|---|---|
| GET | /api/{version}/Region | Get the list of all regions in Colombia |
| HTTP Verbs | Endpoints | Action |
|---|---|---|
| GET | /api/{version}/President | Get the list of all presidents in Colombia |
| GET | /api/{version}/President/{id} | Get the information of a president by it is id |
| GET | /api/{version}/President/name/{name} | Get the information of a president by it is name |
| GET | /api/{version}/President/year/{year} | Get the information of a president that ruled during a specific year |
| GET | /api/{version}/President/search/{keyword} | Get the information of a president searching by keyword |
| GET | /api/{version}/President/pagedList | Get the list of all presidents paginated |
| HTTP Verbs | Endpoints | Action |
|---|---|---|
| GET | /api/{version}/TouristicAttraction | Get the list of all touristic attractions in Colombia |
| GET | /api/{version}/TouristicAttraction/{id} | Get the information of a touristic attraction by it is id |
| GET | /api/{version}/TouristicAttraction/name/{name} | Get the information of a touristic attaction by it is name |
| GET | /api/{version}/TouristicAttraction/search/{keyword} | Get the information of a touristic attaction searching by keyword |
| GET | /api/{version}/TouristicAttraction/pagedList | Get the list of all touristic attractions paginated |
| HTTP Verbs | Endpoints | Action |
|---|---|---|
| GET | /api/{version}/NaturalArea | Get the list of all natural areas in Colombia |
| GET | /api/{version}/NaturalArea/{id} | Get the information of a natural area by it is id |
| GET | /api/{version}/NaturalArea/name/{name} | Get the information of a natural area by it is name |
No open issues yet, or sync has not completed.