TrekkrOS Developer Platform

REST API · SDKs · Integrations · Marketplace

Build travel apps, OTA integrations, and operator automations on top of Nepal's most comprehensive trekking infrastructure API. Route data, real-time conditions, permits, bookings, tea houses, and emergency services — all in one platform.

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

API Reference

Routes & Conditions

GET/v1/routes
60/min

List all trekking routes with filters (difficulty, duration, region)

GET/v1/routes/:id/conditions
120/min

Current trail conditions, weather alerts, and closure status

GET/v1/routes/:id/history
60/min

Historical conditions archive by season and year

Permits & Availability

GET/v1/permits/check
60/min

Check permit requirements and availability for a route/nationality/date

GET/v1/permits/pricing
60/min

Current TIMS, ACAP, MCAP, and national park fee schedule

POST/v1/permits/apply
Auth
10/min

Submit permit application programmatically

Tea Houses

GET/v1/tea-houses
60/min

List tea houses with route, availability, and facilities filters

GET/v1/tea-houses/:id
60/min

Full tea house profile including amenities, reviews, and current status

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

Create a tea house reservation

Emergency Contacts

GET/v1/emergency/contacts
Unlimited

Emergency contacts by region (rescue, hospital, police, embassy)

POST/v1/emergency/dispatch
Auth
5/min

Submit helicopter rescue dispatch request

GET/v1/emergency/hospitals
60/min

Hospitals and altitude medicine clinics with GPS coordinates

Authentication

Authenticated endpoints require a bearer token in the Authorization header. Keys are scoped per API tier and can be rotated in Operator Settings.

# All authenticated requests

Authorization: Bearer tk_live_xxxxxxxxxxxxxxxxxxxxxxxx

Production keys: tk_live_ prefix · Sandbox keys: tk_test_ prefix

Keys never expire — rotate manually if compromised

Never expose keys in client-side code or public repositories

Pricing Tiers

Free

$0

1,000 calls/month · 60 req/min

Route & trail data
Permit pricing
Trail conditions
Tea house listings
Emergency contacts
Weather data
Bookings API
Permits API
Webhooks
SLA guarantee
Most Popular

Pro

$99

/month

100,000 calls/month · 500 req/min

Everything in Free
Bookings CRUD API
Permits application API
Tea house reservation API
Porter & guide availability
Webhooks (booking events)
Revenue analytics API
99.5% SLA
Custom endpoints
Dedicated support

Enterprise

Custom

Unlimited · Custom

Everything in Pro
Custom endpoints
White-label integration
Dedicated account manager
Priority support
99.9% SLA with credits
On-premises data residency
Custom contracts & NDAs

Code Examples

Check Trail Conditions

curl -X GET \
  "https://api.trekkros.com/v1/routes/ebc/conditions" \
  -H "Accept: application/json"

Check Permit Pricing

curl -X GET \
  "https://api.trekkros.com/v1/permits/pricing?route=EBC&nationality=US" \
  -H "Accept: application/json"

Create a Booking (Authenticated)

curl -X POST \
  "https://api.trekkros.com/v1/bookings" \
  -H "Authorization: Bearer tk_live_xxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "route_id": "ebc-standard-14d",
    "start_date": "2026-04-15",
    "party_size": 4,
    "guide_id": "guide-dawa-sherpa"
  }'

Tea House Availability

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

SDKs & Libraries

JavaScript / TypeScript

Available
npm install @trekkros/sdk

Python

Available
pip install trekkros

Go

Beta
go get trekkros.com/go

PHP

Coming soon

Visa & Pre-Arrival Guide

Nepal Visa on Arrival

Available for most nationalities at Tribhuvan International Airport (KTM)

1

Arrive at Tribhuvan International Airport (KTM)

Visa on Arrival counter is in the main arrivals terminal

2

Complete online pre-arrival form

Fill at nepalimmigration.gov.np — saves 20–30 min in queue

3

Choose your visa duration

15 days ($30), 30 days ($50), 90 days ($125) — extendable in Kathmandu

4

Pay at the machine or counter

Major credit cards, USD, EUR accepted. Keep receipt.

5

Complete biometric collection

Fingerprints and photo taken at counter — 5 min process

$30

15 days

$50

30 days

$125

90 days

Currency & Daily Cost Estimator

Exchange Rates to NPR (live)

USD$1 =
NPR 134.8
EUR1 =
NPR 147.2
GBP£1 =
NPR 172.4
AUDA$1 =
NPR 85.3
JPY¥1 =
NPR 0.88

Daily Budget Estimate (USD)

Budget trekker

Accom $5Food $8$18/day

Mid-range

Accom $15Food $18$45/day

Comfort

Accom $35Food $30$90/day

Airline & Transport Partners

RA

Nepal Airlines

National carrier

Int'l + domestic (KTM-Lukla, KTM-Pokhara)

U4

Buddha Air

Premium domestic

Domestic (KTM-Lukla, KTM-Pokhara, KTM-Bharatpur)

YT

Yeti Airlines

Domestic

Domestic (KTM-Lukla, mountain airstrips)

TA

Tara Air

Mountain specialist

Mountain airstrips (Lukla, Phaplu, Jomsom, Manang)

TrekkrOS booking flow integrates flight search for Nepal Airlines, Buddha Air, and Yeti Airlines via TrekkrOS Partner API. Group block rates available for Enterprise tier.

Hotel Pre/Post Trek Integration

Hotel Yak & Yeti

Kathmandu, Durbar Marg

★★★★★

Pre/post trek packages

Pokhara Grande

Pokhara, Lakeside

★★★★★

Annapurna departure hotel

Summit Hotel

Kathmandu, Kopundole

★★★★

Group block rates

Fishtail Lodge

Pokhara, Pewa Lake

★★★★

ABC circuit packages

Thamel Eco Resort

Kathmandu, Thamel

★★★

Budget group rates

Group Block Rates allow operators to pre-book hotel rooms for their client groups at discounted rates. Available via TrekkrOS Partner API for Pro and Enterprise tiers.