TrekkrOS Developer API

v1.0 · REST · JSON

The TrekkrOS API provides programmatic access to trails, bookings, tea houses, porters, weather data, and helicopter dispatch. Build integrations, mobile apps, or automate your operator workflows.

v1.0 Stable
REST / JSON
HTTPS only
Base URLhttps://api.trekkros.com

Overview

The TrekkrOS REST API uses standard HTTP verbs (GET, POST, PUT, DELETE), accepts JSON request bodies, and returns JSON responses. All timestamps are in ISO 8601 UTC format. Errors follow RFC 7807 problem details format.

Protocol

HTTPS/REST

Format

JSON

Auth

Bearer Token

Version

v1

Authentication

All authenticated endpoints require a bearer token in the Authorization header. Get your API key from the Operator Settings page.

# Include in all authenticated requests

Authorization: Bearer tk_live_xxxxxxxxxxxxxxxxxxxxxxxx

Keys are prefixed with tk_live_ (production) or tk_test_ (sandbox)

Never expose API keys in client-side code or public repositories

Keys can be rotated at any time in Operator Settings > API Keys

Endpoint Reference

GET/v1/trails
60/min

List all trekking trails with filters

routedifficultyduration_dayslimitoffset
GET/v1/trails/:id
60/min

Get detailed trail information including waypoints and conditions

id (UUID)
GET/v1/bookings
Auth required
30/min

List operator bookings (operator scope required)

statusstart_dateend_datetrail_id
POST/v1/bookings
Auth required
10/min

Create a new booking

trail_idstart_dateparty_sizecustomer_email
GET/v1/tea-houses
60/min

List tea houses with filters by route and availability

routecheck_incheck_outmin_rooms
POST/v1/tea-houses/:id/reserve
Auth required
10/min

Create a tea house reservation

check_incheck_outroomsmeal_planguests
GET/v1/porters
60/min

List available porters with certification filters

routeavailablecertifiedmax_load_kg
GET/v1/weather/:location
120/min

Get current weather and forecast for a trail location

location (name or lat,lng)days (1-7)
GET/v1/permits/check
60/min

Check permit availability and requirements for a route

routenationalitytrek_date
POST/v1/helicopter/dispatch
Auth required
5/min

Submit an emergency rescue dispatch request

latlngaltitude_mpatient_countconditioninsurance_ref

Code Examples

List EBC Trail Tea Houses

Get all available tea houses on the EBC route for a specific date range

curl -X GET \
  "https://api.trekkros.com/v1/tea-houses?route=EBC&check_in=2026-04-10&check_out=2026-04-24" \
  -H "Accept: application/json"

Authenticated Booking List

Retrieve your operator's confirmed bookings with API key

curl -X GET \
  "https://api.trekkros.com/v1/bookings?status=confirmed" \
  -H "Authorization: Bearer tk_live_xxxxxxxxxxxxxxxxxxxxxxxx" \
  -H "Accept: application/json"

Create Booking

Submit a new trail booking programmatically

curl -X POST \
  "https://api.trekkros.com/v1/bookings" \
  -H "Authorization: Bearer tk_live_xxxxxxxxxxxxxxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "trail_id": "uuid-ebc-route",
    "start_date": "2026-04-10",
    "party_size": 4,
    "customer_email": "trekker@example.com",
    "guide_id": "uuid-guide-dawa"
  }'

Weather for Trail Location

Get 5-day forecast for a specific location

curl -X GET \
  "https://api.trekkros.com/v1/weather/namche-bazaar?days=5" \
  -H "Accept: application/json"

Rate Limits

Free

Per minute60
Per day1,000
Trail data
Weather
Tea house listings

Operator

Your tier
Per minute300
Per day20,000
Full CRUD bookings
Porter management
Revenue analytics
Webhooks

Enterprise

Per minute1000
Per day100,000
Custom endpoints
Dedicated support
SLA 99.9%
White-label

Rate limit headers are returned with every response: X-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-Reset

SDKs & Libraries

JavaScript / TypeScript

Available
npm install @trekkros/sdk

Python

Available
pip install trekkros

Go

Beta
go get trekkros.com/go

PHP

Coming soon