# Omio Price Summary API Documentation

<p><strong>Omio Price Summary API Documentation</strong> 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).</p>

- **Documentation:** [https://scrappa.co/docs/omio-api/omio_summary](https://scrappa.co/docs/omio-api/omio_summary)
- **API group:** Omio API
- **Endpoint:** `GET https://scrappa.co/api/omio/search/summary`

## Authentication

Send your Scrappa API key in the `X-API-KEY` request header. Paid endpoints also support accountless x402 payments when called without an API key.

## Parameters

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `origin_id` | integer | Yes | Position id of the departure place. Get it from the places endpoint. |
| `destination_id` | integer | Yes | Position id of the arrival place. |
| `date_start` | string | Yes | First departure date, YYYY-MM-DD, today or later. |
| `date_end` | string | No | Last departure date, YYYY-MM-DD, at most 62 days after the start. Defaults to 6 days after the start. |
| `travel_mode` | string | No | Comma separated modes: train, bus, flight. Defaults to all three. |
| `adults` | integer | No | Number of adults, 1 to 9. Defaults to 1. |
| `children` | integer | No | Number of children, 0 to 9. Defaults to 0. |
| `infants` | integer | No | Number of infants, 0 to 9. Defaults to 0. |
| `currency` | string | No | Price currency: EUR, USD, GBP, CHF, PLN, CZK, SEK, NOK, DKK, HUF or RON. Defaults to EUR. |
| `calendar` | boolean | No | Set true to add the cheapest price per date across the asked modes. Uses one more request upstream. |

## Example response

```json
{
    "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

| Status | Error | Description |
| --- | --- | --- |
| 422 | Validation Error | A required parameter is missing or invalid. This response is not billable. |
| 404 | Resource Not Found | The search, trip or route was not found or has expired. This response is not billable. |
| 503 | 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. |

## More Scrappa resources

- [API documentation](https://scrappa.co/docs)
- [Full LLM-readable API reference](https://scrappa.co/llms-full.txt)
- [OpenAPI specification](https://scrappa.co/docs/api.json)
- [Pricing](https://scrappa.co/pricing)