Skip to main content
The Duitama Taxi Pricing API calculates official taxi fares based on origin and destination neighborhoods in Duitama, Boyacá, Colombia. Send a pair of neighborhood names and the API returns the applicable fare, fare type (day or night), sector classification, and any active surcharges — all derived from the official rate table. The time and date used for fare calculation are taken automatically from the server clock in the Colombia timezone (UTC-5). You do not need to pass a timestamp. All fares are established by Decreto 033 del 16 de enero de 2026, issued by the municipal government of Duitama. The API implements the complete fare matrix from that decree, including:
  • General sector table (primer sector through cuarto sector)
  • Terminal de Transporte table (different sector assignments for trips involving the bus terminal)
  • Special fixed-rate routes (rutas especiales únicas)
  • Holiday and year-end surcharge of $600 COP (Jueves/Viernes Santo and December 16–31)
  • Night rate applied from 7:00 p.m. to 5:59 a.m.

​
Authentication

No authentication is required. This is a public API with no API keys, tokens, or rate limits.

​
Base URL

EnvironmentBase URL
Local developmenthttp://localhost:3000
ProductionAWS API Gateway URL (generated by SAM deploy)
All API endpoints are versioned under /api/v2026.

​
Endpoints

Calculate fare

POST /api/v2026/calculate-fare — Submit origin and destination neighborhoods to receive the applicable fare.

List zones

GET /api/v2026/zones — Retrieve all sectors with their associated neighborhoods and colors for map display.

Lookup sector

GET /api/v2026/sector?barrio=... — Look up the fare sector for a specific neighborhood.

List neighborhoods

GET /api/v2026/barrios — Get all neighborhoods grouped by sector, for both the general and terminal tables.

Special routes

GET /api/v2026/rutas-especiales — List all fixed-rate special routes defined in the decree.

Health check

GET /health — Verify the service is running and confirm the active decree version.

​
Technology stack

The API is built with the following technologies:
ComponentTechnology
RuntimeNode.js 20
LanguageTypeScript 5.3
FrameworkExpress 5.2
ValidationZod 4.3
DeploymentAWS Lambda via AWS SAM
API GatewayAWS API Gateway REST (with caching on GET endpoints in production)
The Express application runs inside an AWS Lambda function. The API Gateway stage prefix (/qa, /staging, /production) is automatically stripped before requests reach Express, so routes behave identically across all environments.

Build docs developers (and LLMs) love

Get started for freeTalk to us