Quickstart
Make your first fare calculation in under 5 minutes
API Reference
Browse all endpoints with request and response details
Core Concepts
Understand how fares are calculated and prioritized
Deployment
Run locally or deploy to AWS Lambda
How it works
Provide origin and destination
Send the names of the origin and destination neighborhoods in Duitama. The API normalizes accents and casing automatically.
The API determines the fare rule
The engine checks three priority rules in order: special fixed-rate routes, Terminal de Transporte table, and the general sector table.
Day/night rate is applied automatically
The API reads the current time in Colombia (UTC-5). Fares after 7:00 p.m. and before 6:00 a.m. use the nighttime rate.
Key features
5 pricing sectors
Neighborhoods are classified into primer, segundo, tercer, cuarto sector, and tarifa especial — each with its own day and night rate.
Special fixed routes
Four special routes (Cogollo, Tribuna, Ciudadela Industrial, La Trinidad) have fixed fares that override sector logic.
Terminal de Transporte fares
Trips to or from the bus terminal use a separate pricing table, as specified by the decree.
Holiday surcharges
An automatic +$600 surcharge applies on Holy Thursday, Holy Friday, and December 16–31.
This API is public and requires no authentication. All endpoints return JSON.