Omio Price Summary API Documentation Read the cheapest price for every day of a date range, split by mode (train, bus, flight), with the number of results behind each price. Only modes that you asked for and that have results are listed, so a mode without trips never shows as a zero price. Each day also names the cheapest mode. Set calendar to true to add calendar_minimum: the cheapest price per date across the asked modes, without a mode label. The range is at most 62 days. Prices are in minor units (cents).
Run this endpoint
Endpoint
Parameters
Start with the required fields, then add optional filters only when your use case needs them.
Runnable path
3 required parameters needed before sending a request.
7 optional filters available.
integer
Required
Position id of the departure place. Get it from the places endpoint.
1234567890
integer
Required
Position id of the arrival place.
1234567890
string
Required
First departure date, YYYY-MM-DD, today or later.
2026-06-15
string
Optional
Last departure date, YYYY-MM-DD, at most 62 days after the start. Defaults to 6 days after the start.
2026-06-15
string
Optional
Comma separated modes: train, bus, flight. Defaults to all three.
example
integer
Optional
Number of adults, 1 to 9. Defaults to 1.
10
integer
Optional
Number of children, 0 to 9. Defaults to 0.
10
integer
Optional
Number of infants, 0 to 9. Defaults to 0.
10
string
Optional
Price currency: EUR, USD, GBP, CHF, PLN, CZK, SEK, NOK, DKK, HUF or RON. Defaults to EUR.
USD
boolean
Optional
Set true to add the cheapest price per date across the asked modes. Uses one more request upstream.
true
Response Schema
Example response fields are illustrative; inspect the JSON before integrating.
Example response fields
Scan these fields before integrating.
data
meta
success
{
"data": {
"days": [
{
"date": "2026-11-14",
"modes": {
"bus": {
"price": {
"currency": "EUR",
"amount_minor": 4698
},
"updated_at": "2026-10-20T10:48:36.098459661Z",
"results_count": 23
},
"train": {
"price": {
"currency": "EUR",
"amount_minor": 9499
},
"updated_at": "2026-10-19T15:41:23.24560686Z",
"results_count": 35
},
"flight": {
"price": {
"currency": "EUR",
"amount_minor": 13961
},
"updated_at": "2026-10-20T10:48:36.098459661Z",
"results_count": 87
}
},
"cheapest_mode": "bus",
"cheapest_price": {
"currency": "EUR",
"amount_minor": 4698
}
},
{
"date": "2026-11-15",
"modes": {
"bus": {
"price": {
"currency": "EUR",
"amount_minor": 4798
},
"updated_at": "2026-10-20T10:38:44.487040617Z",
"results_count": 47
},
"train": {
"price": {
"currency": "EUR",
"amount_minor": 8999
},
"updated_at": "2026-10-20T08:05:13.140281081Z",
"results_count": 45
},
"flight": {
"price": {
"currency": "EUR",
"amount_minor": 15630
},
"updated_at": "2026-10-20T10:38:44.487040617Z",
"results_count": 90
}
},
"cheapest_mode": "bus",
"cheapest_price": {
"currency": "EUR",
"amount_minor": 4798
}
}
],
"modes": [
"train",
"bus",
"flight"
],
"currency": "EUR",
"date_end": "2026-11-15",
"origin_id": 376217,
"date_start": "2026-11-14",
"days_count": 2,
"destination_id": 379727,
"calendar_minimum": [
{
"date": "2026-11-14",
"price": {
"currency": "EUR",
"amount_minor": 4698
}
},
{
"date": "2026-11-15",
"price": {
"currency": "EUR",
"amount_minor": 4798
}
},
{
"date": "2026-11-16",
"price": {
"currency": "EUR",
"amount_minor": 4841
}
},
{
"date": "2026-11-17",
"price": {
"currency": "EUR",
"amount_minor": 4298
}
},
{
"date": "2026-11-18",
"price": {
"currency": "EUR",
"amount_minor": 4198
}
}
]
},
"meta": {
"billable": true,
"endpoint_family": "price_summary"
},
"success": true
}Errors
Handle these documented responses before retrying or showing customer-facing failures.
Validation Error
A required parameter is missing or invalid. This response is not billable.
{
"errors": {
"date_start": [
"A start date is required, formatted YYYY-MM-DD."
]
},
"message": "The request validation failed"
}Resource Not Found
The search, trip or route was not found or has expired. This response is not billable.
{
"meta": {
"billable": false,
"retryable": false,
"endpoint_family": "price_summary"
},
"error": {
"code": "NOT_FOUND",
"message": "The requested Omio resource was not found."
},
"success": false
}Service Unavailable
Omio could not be reached, did not finish the search in time, or answered with an unexpected shape. This response is not billable.
{
"meta": {
"billable": false,
"retryable": true,
"endpoint_family": "price_summary"
},
"error": {
"code": "UPSTREAM_UNAVAILABLE",
"message": "The Omio API is temporarily unavailable. Please retry."
},
"success": false
}Generate Code with AI
Copy a ready-made prompt with all the endpoint details, parameters, and example responses. Paste it into ChatGPT, Claude, or any AI assistant to instantly generate working code.
Try It Live
Test this endpoint in our interactive playground with real data.