Scandinavia Transit Skill

Search ground transport (trains, buses, ferries) within Norway, Sweden, and Denmark using their national transit APIs.

Sources:

• Entur (Norway) — Open GraphQL API for all Norwegian transit
• ResRobot (Sweden) — REST API via Trafiklab for all Swedish transit
• Rejseplanen (Denmark) — REST API (HAFAS) for all Danish transit including pricing

Norway: Entur (Journey Planner v3)

Open GraphQL API. No key needed (but a client name header is required). Covers ALL Norwegian transit: Vy trains, buses, ferries, trams, metro. 60+ operators.

Trip Search (Oslo to Bergen example)

bash
curl -s -X POST "https://api.entur.io/journey-planner/v3/graphql" \
  -H "Content-Type: application/json" \
  -H "ET-Client-Name: $ENTUR_CLIENT_NAME" \
  -d '{"query": "{ trip(from: {place: \"NSR:StopPlace:59872\"}, to: {place: \"NSR:StopPlace:548\"}, numTripPatterns: 5) { tripPatterns { startTime duration legs { mode expectedStartTime expectedEndTime fromPlace { name } toPlace { name } line { publicCode name authority { name } } } } } }"}' | jq '.data.trip.tripPatterns[] | {start: .startTime, duration_min: (.duration / 60), legs: [.legs[] | {mode: .mode, from: .fromPlace.name, to: .toPlace.name, line: .line.publicCode, operator: .line.authority.name, depart: .expectedStartTime, arrive: .expectedEndTime}]}'

Find Stop IDs

Stop IDs use the format NSR:StopPlace:XXXXX. Find them via the Geocoder:

bash
curl -s "https://api.entur.io/geocoder/v1/autocomplete?text=Oslo%20S&size=3" \
  -H "ET-Client-Name: $ENTUR_CLIENT_NAME" | jq '[.features[] | {name: .properties.name, id: .properties.id, type: .properties.layer}]'

Key Stop IDs

| City | Stop ID | Name | |------|---------|------| | Oslo S | NSR:StopPlace:59872 | Oslo S | | Bergen | NSR:StopPlace:548 | Bergen stasjon | | Stavanger | NSR:StopPlace:4130 | Stavanger | | Trondheim | NSR:StopPlace:41742 | Trondheim S | | Bodo | NSR:StopPlace:49484 | Bodo stasjon |

Use the Geocoder to find any stop. Works for airports, ferry terminals, bus stops too.

Departure Board

bash
curl -s -X POST "https://api.entur.io/journey-planner/v3/graphql" \
  -H "Content-Type: application/json" \
  -H "ET-Client-Name: $ENTUR_CLIENT_NAME" \
  -d '{"query": "{ stopPlace(id: \"NSR:StopPlace:59872\") { name estimatedCalls(numberOfDepartures: 10) { expectedDepartureTime destinationDisplay { frontText } serviceJourney { journeyPattern { line { publicCode name transportMode } } } } } }"}' | jq '.data.stopPlace | {name: .name, departures: [.estimatedCalls[] | {time: .expectedDepartureTime, destination: .destinationDisplay.frontText, line: .serviceJourney.journeyPattern.line.publicCode, mode: .serviceJourney.journeyPattern.line.transportMode}]}'

Notes

• GraphQL API. POST only. One endpoint: https://api.entur.io/journey-planner/v3/graphql
• Set ET-Client-Name header on all requests.
• No rate limit key, but respectful usage expected.
• Schema explorer: https://api.entur.io/graphql-explorer/journey-planner-v3
• Covers some cross-border routes into Sweden via Vy and SJ Nord.

Sweden: ResRobot v2.1

REST API via Trafiklab. Covers ALL Swedish transit: SJ trains, regional buses, ferries, metro, commuter rail.

Authentication

RESROBOT_API_KEY in .env. Use accessId query parameter. Free key at trafiklab.se. 30,000 calls/month.

Trip Search (Stockholm to Gothenburg)

bash
curl -s "https://api.resrobot.se/v2.1/trip?originId=740000001&destId=740000002&format=json&accessId=$RESROBOT_API_KEY" | jq '[.Trip[] | {start: .LegList.Leg[0].Origin.time, date: .LegList.Leg[0].Origin.date, duration: .duration, legs: [.LegList.Leg[] | {mode: .type, name: .name, from: .Origin.name, to: .Destination.name, depart: .Origin.time, arrive: .Destination.time}]}] | .[0:5]'

Find Stop IDs

bash
curl -s "https://api.resrobot.se/v2.1/location.name?input=Stockholm&format=json&accessId=$RESROBOT_API_KEY" | jq '[.stopLocationOrCoordLocation[] | .StopLocation | {name: .name, id: .extId}] | .[0:5]'

Key Stop IDs

| City | Stop ID | Name | |------|---------|------| | Stockholm C | 740000001 | Stockholm Centralstation | | Gothenburg C | 740000002 | Goteborg Centralstation | | Malmo C | 740000003 | Malmo Centralstation | | Uppsala | 740000025 | Uppsala Centralstation | | Linkoping | 740000009 | Linkoping Centralstation |

Trip Parameters

| Param | Required | Description | |-------|----------|-------------| | originId | Yes | Departure stop ID | | destId | Yes | Arrival stop ID | | date | No | YYYY-MM-DD (default today) | | time | No | HH:MM (default now) | | format | No | json or xml | | numTrips | No | Number of results (default 5) | | products | No | Bitmask for transport types |

Notes

• REST API. Base: https://api.resrobot.se/v2.1/
• Includes cross-border Oresund trains to Copenhagen.
• No pricing data. Schedule/route only.

Denmark: Rejseplanen API 2.0

REST API (HAFAS v2.50.4.1). Covers ALL Danish transit: DSB InterCity/InterCityLyn, S-Tog, Metro, regional trains, buses, express buses, night buses, ferries, Flextur. Unique: includes fare/zone pricing data.

Docs: https://labs.rejseplanen.dk (login required). XSD schemas: https://www.rejseplanen.dk/api/xsd

Authentication

REJSEPLANEN_API_KEY in .env. Pass as accessId query parameter. Apply at labs.rejseplanen.dk. 50,000 calls/month free (non-commercial).

Common Parameters

| Param | Description | |-------|-------------| | accessId | Required. API key. | | format | json or xml. Always use format=json. | | lang | Default da. Use lang=en for English. |

Product Bitmask

| Value | Product | Description | |-------|---------|-------------| | 1 | IC | InterCity | | 2 | ICL | InterCityLyn (express) | | 4 | Re | Regional train | | 8 | Other | ECE, Eurostar, RailJet, Togbus, DSB Udland | | 16 | S-Tog | Copenhagen commuter rail | | 32 | Bus | Local bus | | 64 | ExpressBus | Express bus (250S, X-bus) | | 128 | NightBus | Natbus | | 256 | Flextur | Demand-responsive transport | | 1024 | Metro | Copenhagen Metro |

Trains only = products=31. All transit = omit param.

Key Stop IDs

| Stop | extId | Name | |------|-------|------| | København H | 8600626 | København H | | CPH Lufthavn | 8600858 | CPH Lufthavn | | Odense St. | 8600512 | Odense St. | | Aarhus H | 8600053 | Aarhus H | | Aalborg St. | 8600020 | Aalborg St. | | Svendborg St. | 8600551 | Svendborg St. | | Svendborg Færgehavn | 100200261 | Svendborg Færgehavn | | Ærøskøbing Havn (færge) | 100200222 | Ærøskøbing Havn (færge) |

Location Endpoints

location.name (Search by Name)

bash
curl -s "https://www.rejseplanen.dk/api/location.name?accessId=$REJSEPLANEN_API_KEY&input=København&format=json&type=S" | jq '[.stopLocationOrCoordLocation[] | .StopLocation | {name: .name, id: .extId, lat: .lat, lon: .lon}] | .[0:10]'

| Param | Required | Description | |-------|----------|-------------| | input | Yes | Search query | | type | No | S (stops), A (addresses), P (POI), or combine | | maxNo | No | Max results (default 10, max 1000) | | products | No | Product bitmask filter | | r, refCoordLat, refCoordLong | No | Radius + reference coordinate for distance ranking |

location.nearbystops (Stops Near Coordinate)

bash
curl -s "https://www.rejseplanen.dk/api/location.nearbystops?accessId=$REJSEPLANEN_API_KEY&originCoordLat=55.672793&originCoordLong=12.564590&r=500&format=json" | jq '[.stopLocationOrCoordLocation[] | .StopLocation | {name: .name, id: .extId, dist: .dist}] | .[0:10]'

Requires originCoordLat/originCoordLong. Optional: r (radius, default 1000m), maxNo, type, products.

location.details

Single location details by full HAFAS ID (URL-encoded).

location.data

Locations in a numeric ID range (llId to urId).

location.search

Filtered location search. Same params as location.name plus additional filters.

location.boundingbox

All stops in a geographic box (llLat/llLon to urLat/urLon).

addresslookup

Addresses near a coordinate. Reverse geocoding. Requires originCoordLat/originCoordLong.

Trip Planning Endpoints

trip (Route Planning)

bash
curl -s "https://www.rejseplanen.dk/api/trip?accessId=$REJSEPLANEN_API_KEY&originId=8600626&destId=8600551&date=2026-08-28&time=08:00&format=json&lang=en" | jq '[.TripList.Trip[] | {duration: .duration, legs: [.LegList.Leg[] | {name: .name, type: .type, from: .Origin.name, to: .Destination.name, depTime: .Origin.time, arrTime: .Destination.time, track: .Origin.track}]}] | .[0:3]'

| Param | Required | Description | |-------|----------|-------------| | originId | Yes | Origin stop extId | | `destId` | Yes | Destination stop extId | | originCoordLat/Long | Yes | Origin by coordinate (alt to originId) | | `destCoordLat/Long` | Yes | Destination by coordinate (alt to destId) | | date | No | YYYY-MM-DD | | time | No | HH:MM | | searchForArrival | No | 1 = search by arrival time | | numF | No | Forward results (1-6) | | numB | No | Backward results (0-3) | | maxChange | No | Max transfers (0-11) | | products | No | Product bitmask | | operators | No | Comma-separated operator codes | | lines | No | Line filter | | via | No | Via stop ID | | avoid | No | Avoid stop ID | | passlist | No | 1 = include intermediate stops | | tariff | No | 1 = include fare/zone pricing | | poly | No | 1 = include polyline | | context | No | Scroll token for paging | | originWalk/Bike/Car | No | Access mode distance | | destWalk/Bike/Car | No | Egress mode distance | | rtMode | No | FULL, INFOS, OFF, REALTIME, SERVER_DEFAULT |

interval (Interval Trip Search)

All departures in a time window. Same params as trip.

recon (Trip Reconstruction)

Reconstruct trip from ctxRecon token. Params: ctx (required), poly, passlist, tariff.

reachability (All Reachable Stops)

All stops reachable within time/transfer budget. Params: originId or coordinates, duration (1-1439 min), maxChange (0-11), forward, products.

Departure and Arrival Boards

Default duration: 60 minutes.

departureBoard / arrivalBoard

bash
curl -s "https://www.rejseplanen.dk/api/departureBoard?accessId=$REJSEPLANEN_API_KEY&id=8600626&date=2026-08-28&time=08:00&format=json&lang=en" | jq '[.DepartureBoard.Departure[] | {name: .name, time: .time, direction: .direction, track: .track, rtTime: .rtTime}] | .[0:10]'

Params: id (required), date, time, duration (0-1439), maxJourneys, products, operators, passlist.

multiDepartureBoard / multiArrivalBoard

Multiple stations in one call. Pass multiple id params.

nearbyDepartureBoard / nearbyArrivalBoard

Stations near a coordinate. Params: originCoordLat/Long, r (default 1000m), maxStops (default 30).

Line and Journey Endpoints

lineinfo

Line details on a date. Requires lineId, date.

linesched

Full schedule for a line on a date. Requires lineId, date.

linesearch

All lines by operator. Requires operators (comma-separated, from datainfo).

linematch

Match lines by pattern string.

trainSearch

Find journeys by train name. Returns first/last stop only.

journeyDetail

Full stop list for a journey. Requires id (journey ref from trip/board). Optional: fromId/toId, poly, rtMode.

journeyMatch

Like trainSearch but full details for first match only.

journeypos

Real-time vehicle positions in bounding box. Requires llLat/llLon/urLat/urLon.

Tariff / Pricing Endpoints

Denmark uses zone-based pricing via Rejsekort. Unique in Scandinavia.

| Endpoint | Purpose | |----------|---------| | trip with tariff=1 | Inline pricing in trip results | | spPrice | Season pass price by origin/destination | | spPriceForZones | Price per day for zone count in fare set | | spDailyZonalPrices | Full zone price matrix, all passenger types | | spPriceReconstruction | Price from trip reconstruction context | | spRefund | Season pass refund calculation | | spCheck | Season pass validation (SELF system) | | spZoneCheck | Check zone connectivity and metro zones | | stRoutes | Tariff routes between origin/destination | | stRoutesAddon | Tariff routes from single origin | | stStops | Tariff zones and stops (mode=DSB) | | trfStop | Default stop for a zone | | convertZones | Tariff details for context | | zoneFromCoordinate | Zone lookup by lat/lon |

Travel Detail Endpoints

gisroute

Walking/cycling route details from trip result. Requires ctx (GIS reference).

himsearch

Real-time disruption messages. Filterable by products, operators, lines, dates, stops.

System Information

datainfo

All operators, products, categories. Use to discover operator codes.

bash
curl -s "https://www.rejseplanen.dk/api/datainfo?accessId=$REJSEPLANEN_API_KEY&format=json" | jq '[.DataInfo.operators.Operator[] | {name: .name, id: .id}] | .[0:20]'

tti

Timetable data pool info: ID, creation date, type (ST/ADR/POI), validity period.

Response Structure

• extId: Numeric stop ID (use for queries). id is the full HAFAS string.
• rtTime/rtDate: Real-time actual/predicted times (when different from scheduled time/date).
• Leg type: JNY (journey), WALK (walking), TRSF (transfer).
• JourneyDetailRef: Use with journeyDetail for full stop list.

Cross-Border Routes

| Route | Covered By | Notes | |-------|------------|-------| | Oslo to Stockholm | Entur + ResRobot | SJ trains, ~6 hours | | Malmö to Copenhagen | ResRobot + Rejseplanen | Øresund trains, 35 min | | Gothenburg to Oslo | Entur + ResRobot | Vy/SJ, ~4 hours | | Stockholm to Copenhagen | ResRobot | SJ/DSB, ~5 hours via Malmö | | Copenhagen to Malmö | Rejseplanen | Øresund trains from Danish side |

When to Use

Load this skill when:

• Planning train/bus/ferry routes between Scandinavian cities
• Checking schedules and durations for ground transport
• Finding stop IDs for trip planning
• Comparing train vs flight for intra-Scandinavia legs
• Looking up Danish transit fares/zones
• Checking real-time disruptions (himsearch)
• Tracking live vehicle positions (journeypos)

Do not:

• Use for booking (search/schedule only)
• Use for flights (use Seats.aero, SerpAPI, or Duffel)
• Expect pricing from Entur or ResRobot (only Rejseplanen has pricing)

Search Workflows

1. "How do I get from A to B?"

Step 1: Pick API by country (Norway=Entur, Sweden=ResRobot, Denmark=Rejseplanen, cross-border=both).

Step 2: Find stop IDs:

bash
# Norway
curl -s "https://api.entur.io/geocoder/v1/autocomplete?text=Flåm&size=3" \
  -H "ET-Client-Name: $ENTUR_CLIENT_NAME" | jq '[.features[] | {name: .properties.name, id: .properties.id}]'

# Sweden
curl -s "https://api.resrobot.se/v2.1/location.name?input=Malmö&format=json&accessId=$RESROBOT_API_KEY" | jq '[.stopLocationOrCoordLocation[] | .StopLocation | {name: .name, id: .extId}] | .[0:5]'

# Denmark
curl -s "https://www.rejseplanen.dk/api/location.name?accessId=$REJSEPLANEN_API_KEY&input=Svendborg&format=json&type=S&lang=en" | jq '[.stopLocationOrCoordLocation[] | .StopLocation | {name: .name, id: .extId}] | .[0:5]'

Step 3: Trip search with date and time. Step 4 (Denmark): Add tariff=1 for pricing.

2. "What trains leave from X?"

bash
curl -s "https://www.rejseplanen.dk/api/departureBoard?accessId=$REJSEPLANEN_API_KEY&id=8600626&duration=120&products=31&format=json&lang=en" | jq '[.DepartureBoard.Departure[] | {time: .time, name: .name, direction: .direction, track: .track}]'

3. "What's near me?"

bash
curl -s "https://www.rejseplanen.dk/api/location.nearbystops?accessId=$REJSEPLANEN_API_KEY&originCoordLat=55.6736&originCoordLong=12.5681&r=500&format=json&lang=en" | jq '[.stopLocationOrCoordLocation[] | .StopLocation | {name: .name, id: .extId, dist: .dist}]'

Or nearbyDepartureBoard to skip stop lookup.

4. "What ferry to Ærø?"

bash
curl -s "https://www.rejseplanen.dk/api/trip?accessId=$REJSEPLANEN_API_KEY&originId=100200261&destId=100200222&date=2026-08-28&time=08:00&format=json&lang=en" | jq '[.TripList.Trip[] | {legs: [.LegList.Leg[] | {name: .name, from: .Origin.name, to: .Destination.name, depTime: .Origin.time, arrTime: .Destination.time}]}] | .[0:5]'

5. "I know the train number."

trainSearch to find it, then journeyDetail with the ref for full stops.

6. "What can I reach in 2 hours?"

bash
curl -s "https://www.rejseplanen.dk/api/reachability?accessId=$REJSEPLANEN_API_KEY&originId=8600626&duration=120&maxChange=2&format=json" | jq '.'

7. "Any disruptions?"

bash
curl -s "https://www.rejseplanen.dk/api/himsearch?accessId=$REJSEPLANEN_API_KEY&format=json&lang=en" | jq '.'

8. Multi-country trips

Search from both ends. Øresund trains appear in both ResRobot and Rejseplanen.

Tips

• Always format=json. Always lang=en for Rejseplanen.
• Use extId (numeric) for queries, not the long HAFAS id string.
• Check rtTime/rtDate for delays.
• passlist=1 shows intermediate stops.
• maxChange=0 for direct connections only.
• Page with numF/numB or context scroll tokens.
• Product bitmask is additive. Omit for all types.