# Lanzamiento de la API pública gratuita de kilometraje

> Cinco endpoints REST, autenticación por API key y free tier de 1.000 peticiones por ventana de 30 días.

**Autor:** Camila Ribeiro — Editora de Operaciones de Campo  
**Publicado:** 2026-05-02  
**Actualizado:** 2026-05-02  
**URL:** https://kilometraje.co/blog/lanzamiento-de-la-api-publica-gratuita-de-kilometraje

**TL;DR:** Cinco endpoints REST, autenticación por API key y free tier de 1.000 peticiones por ventana de 30 días.

- El reembolso de kilometraje es una de las piezas más olvidadas del stack de gastos corporativos.
- POST /distance calcula distancia y duración entre dos puntos, aceptando direcciones libres o pares lat/lng.
- La clave va en el header X-API-Key (o como Bearer).
- Clientes oficiales en JavaScript/TypeScript (npm install quilometragem-sdk-js) y Python (pip install quilometragem), ambos bajo licencia MIT.
- Inicia sesión, abre /account/api, crea una clave (la verás una sola vez) y prueba con cURL al endpoint /distance.

## Por qué publicamos una API pública

El reembolso de kilometraje es una de las piezas más olvidadas del stack de gastos corporativos.[^irs-2025] La mayoría de los equipos sigue usando hojas de cálculo. La API pública de Quilometragem soluciona esto con cinco endpoints REST: distancia GPS, tarifa oficial por país, cálculo de reembolso, recibo PDF firmado y geocodificación. Todo gratuito hasta 1.000 peticiones por ventana de 30 días por clave.

## Los cinco endpoints

`POST /distance` calcula distancia y duración entre dos puntos, aceptando direcciones libres o pares lat/lng. `POST /reimbursement` aplica la tarifa oficial del país y año indicados — actualmente cubrimos US, BR, MX, CO, UK y CA. `POST /receipt` genera un PDF con hash SHA-256 que aguanta auditoría. `GET /rates/{country}/{year}` devuelve la tarifa oficial con link a la fuente. `GET /geocode` convierte una dirección en coordenadas.

## Autenticación y límites

La clave va en el header `X-API-Key` (o como Bearer). Cada respuesta lleva `X-RateLimit-Limit` y `X-RateLimit-Remaining`. El free tier de 1.000 peticiones por ventana de 30 días rolling cubre prototipos, hackathons y equipos pequeños. Cuando necesites más, hay un plan partner con volúmenes a medida.

## SDKs y OpenAPI

Clientes oficiales en JavaScript/TypeScript (`npm install quilometragem-sdk-js`) y Python (`pip install quilometragem`), ambos bajo licencia MIT. Para otros lenguajes, importa nuestro OpenAPI 3.1 en `https://quilometragem.com/api/openapi.json`. Los ejemplos cURL, Axios, Ruby, Go y PHP están en la documentación interactiva en `/api`.

## Cómo empezar en 60 segundos

Inicia sesión, abre `/account/api`, crea una clave (la verás una sola vez) y prueba con cURL al endpoint `/distance`. Recibes distancia en km, duración estimada y polyline de la ruta.

## Fuentes

- [IRS — Standard Mileage Rates for 2025](https://www.irs.gov/tax-professionals/standard-mileage-rates) — Internal Revenue Service (2026-04-28)
- [OpenStreetMap — Map data and routing](https://www.openstreetmap.org/about) — OpenStreetMap Foundation (2026-04-28)