Tours of Iceland

Partner API

A read-only, server-to-server JSON API for tours and transfer quotes. Keys are issued by a Tours of Iceland administrator — contact us to request one.

Authentication

Send your key in the x-api-key header (or Authorization: Bearer). Keys look like toi_live_…. Never expose a key in a browser or mobile app.

Scopes

  • tours:read — list/get tours
  • transfers:quote — transfer quotes

Base URL: /api/v1 · Rate-limited per key (default 60/min; 429 with Retry-After when exceeded).

Quick start

# List published tours
curl -H "x-api-key: toi_live_YOUR_KEY" \
  https://toursoficeland.is/api/v1/tours

# Quote a transfer (Iceland Place IDs)
curl -X POST https://toursoficeland.is/api/v1/transfers/quote \
  -H "x-api-key: toi_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "fromPlaceId": "ChIJ...KEF",
    "toPlaceId": "ChIJ...RVK",
    "pickupAt": "2026-07-01T09:00:00Z",
    "passengers": 2
  }'

Reference