Get a single trip (one vehicle run) with stop times
Return a single trip (one scheduled vehicle run) as an ordered list of stops with arrival/departure times and GTFS boarding rules (pickupType/dropOffType). Addressed by tripId + regionName from a /v1/nextDepartures or /v1/rawVehiclePositions response.
Response fields and units
| Field | Format / unit | Meaning |
|---|---|---|
stops[].arrivalTime, stops[].departureTime | ISO 8601 with UTC offset | Scheduled time in the route's local timezone |
stops[].stopLat, stops[].stopLon | WGS 84 decimal degrees | Stop coordinates |
processingTimeMs | milliseconds | Server processing time |
Parameters
| Parameter | Type | Required | Description | Example |
|---|---|---|---|---|
tripId | string | Yes | Trip identifier as returned by /v1/nextDepartures (in a departure entry) or /v1/rawVehiclePositions; forwarded to the backend verbatim | 3087978050 |
regionName | string | Yes | Region name that selects the backend, taken from the same /v1/nextDepartures or /v1/rawVehiclePositions response | germany |
lang | string | No | Language code for translated stop/route names (IETF BCP 47 format) | en |
Boarding rules
A stop can restrict whether passengers may board or alight (GTFS pickup_type / drop_off_type). Two optional fields carry this; each appears on a stop ONLY when that action is forbidden - if a field is absent the action is allowed:
| Field | Meaning when present (=1) |
|---|---|
pickupType | Boarding (pickup) is not allowed at this stop - drop-off only. |
dropOffType | Alighting (drop-off) is not allowed at this stop - boarding only. |
Wheelchair accessibility
wheelchairBoarding: wheelchairBoarding describes a stop.
wheelchairAccessible: wheelchairAccessible describes a trip.
| Value | Meaning |
|---|---|
field absent | Unknown (GTFS value 0). |
1 | Accessible. |
2 | Not accessible. |
Try It Out
Required parameters only
curl -H "capi-key: Bearer YOUR_API_KEY" \
-H "capi-host: busmaps.com" \
"https://capi.busmaps.com:8443/v1/trip?tripId=3087978050®ionName=germany"Popular parameters
curl -H "capi-key: Bearer YOUR_API_KEY" \
-H "capi-host: busmaps.com" \
"https://capi.busmaps.com:8443/v1/trip?tripId=3087978050®ionName=germany&lang=en"Response Example
{
"tripId": "3087978050",
"routeId": "1579968320-1148302324",
"countryIso": "DEU",
"countryUrl": "germany",
"routeShortName": "28",
"urlRouteShortName": "28",
"routeType": "train",
"tripHeadsign": "M\u00fcnchen Hbf",
"agencyId": "4175707078-180312815",
"agencyName": "DB Fernverkehr Ag",
"urlAgencyName": "DB-Fernverkehr-Ag",
"agencyUrl": "https://www.delfi.de",
"stops": [
{
"stopId": "2816067872220830083",
"countryIso": "DEU",
"countryUrl": "germany",
"stopName": "Hamburg-Altona",
"urlStopName": "Hamburg-Altona",
"stopLat": 53.552695,
"stopLon": 9.935175,
"arrivalTime": "2026-06-09T06:17:00+02:00",
"departureTime": "2026-06-09T06:17:00+02:00"
},
{
"stopId": "1317189768892492088",
"countryIso": "DEU",
"countryUrl": "germany",
"stopName": "Hamburg Dammtor",
"urlStopName": "Hamburg-Dammtor",
"stopLat": 53.560751,
"stopLon": 9.989566,
"arrivalTime": "2026-06-09T06:25:00+02:00",
"departureTime": "2026-06-09T06:27:00+02:00",
"dropOffType": 1
}
],
"polyline": "kozeIyms{@iq@_sI`q@ikB?A|yeEgbnRt{@gp`@ntHtSttuBtjhC|yn@~mbAtdu@qvK|zgAloeGnhpEr`Zj@Mfmz@g|RdAWxi\\m{Nlz}Fwx{A",
"regionName": "germany",
"processingTimeMs": 64.19
}Response Schema
View JSON Schema
{
"$schema": "http://json-schema.org/draft-07/schema#",
"title": "Trip Response",
"type": "object",
"properties": {
"urlRouteShortName": {
"type": "string",
"description": "URL-safe slug of the route short name"
},
"agencyUrl": {
"type": "string",
"description": "Agency website URL"
},
"routeColor": {
"type": "string",
"description": "Route color as a hex string"
},
"routeShortName": {
"type": "string",
"description": "Short route name shown to passengers"
},
"stops": {
"type": "array",
"items": {
"type": "object",
"properties": {
"stopLon": {
"type": "number",
"description": "Stop longitude in decimal degrees"
},
"stopDesc": {
"type": "string",
"description": "Additional stop description (platform/track hint)"
},
"wheelchairBoarding": {
"type": "integer",
"description": "Wheelchair accessibility of the stop",
"enum": [
1,
2
]
},
"countryUrl": {
"type": "string",
"description": "Country URL slug (e.g. 'uk')"
},
"urlStopName": {
"type": "string",
"description": "URL-safe slug of the stop name"
},
"dropOffType": {
"type": "integer",
"description": "GTFS drop-off rule at this stop: 0 alighting allowed, 1 no alighting. Present only when restricted; absent means allowed"
},
"countryIso": {
"type": "string",
"description": "ISO 3166-1 alpha-3 country code (e.g. 'GBR')"
},
"departureTime": {
"type": "string",
"description": "Scheduled departure time (ISO 8601, route-local with offset)"
},
"stopId": {
"type": "string",
"description": "Internal stop identifier (use with /nextDepartures stopId mode)"
},
"stopLat": {
"type": "number",
"description": "Stop latitude in decimal degrees"
},
"arrivalTime": {
"type": "string",
"description": "Scheduled arrival time (ISO 8601, route-local with offset)"
},
"stopName": {
"type": "string",
"description": "Human-readable stop name"
}
},
"required": [
"stopLon",
"departureTime",
"stopId",
"stopLat",
"stopName",
"countryUrl",
"arrivalTime",
"urlStopName",
"countryIso"
]
},
"description": "Ordered stops served by this trip"
},
"processingTimeMs": {
"type": "number",
"description": "Server processing time in milliseconds"
},
"tripId": {
"type": "string",
"description": "Trip identifier (pass it back to re-query this run)"
},
"routeId": {
"type": "string",
"description": "Internal route identifier of the trip"
},
"countryIso": {
"type": "string",
"description": "ISO 3166-1 alpha-3 country code (e.g. 'GBR')"
},
"routeLongName": {
"type": "string",
"description": "Full route name/description"
},
"agencyName": {
"type": "string",
"description": "Operating agency name"
},
"agencyPhone": {
"type": "string",
"description": "Agency contact phone"
},
"regionName": {
"type": "string",
"description": "Transit data region that served the request"
},
"agencyId": {
"type": "string",
"description": "Internal agency identifier"
},
"tripHeadsign": {
"type": "string",
"description": "Destination shown on the vehicle"
},
"wheelchairAccessible": {
"type": "integer",
"description": "Wheelchair accessibility of the trip",
"enum": [
1,
2
]
},
"countryUrl": {
"type": "string",
"description": "Country URL slug (e.g. 'uk')"
},
"polyline": {
"type": "string",
"description": "Google-encoded geometry of the whole trip"
},
"routeDesc": {
"type": "string",
"description": "Additional route description"
},
"routeType": {
"type": "string",
"description": "Transport type (bus, subway, train, tram, ...)"
},
"urlAgencyName": {
"type": "string",
"description": "URL-safe slug of the agency name"
},
"routeTextColor": {
"type": "string",
"description": "Route text color as a hex string"
}
},
"required": [
"polyline",
"urlRouteShortName",
"agencyUrl",
"routeType",
"countryIso",
"agencyId",
"regionName",
"tripHeadsign",
"urlAgencyName",
"routeShortName",
"stops",
"countryUrl",
"agencyName",
"processingTimeMs",
"tripId",
"routeId"
]
}Response Codes
200
Trip with ordered stops and stop times400
Invalid or missing parameters / unknown regionName404
Trip not found500
Internal server error