# Omio Providers API Documentation

<p><strong>Omio Providers API Documentation</strong> With a search_id this lists the carriers of that search: name, code, logo, the codes used by rail operators and airlines, the modes they run, the number of trips and their cheapest price. It also lists the booking providers Omio uses for the search. Without a search_id it returns the catalogue of discount cards and railcards per provider, with card ids and names. Both answers use no new search.</p>

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

## 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 |
| --- | --- | --- | --- |
| `search_id` | string | No | The search id from search_meta.search_id. Without it the discount card catalogue is returned. |
| `lang` | string | No | Language of the card names: en, de, fr, es, it, nl, pt or pl. Defaults to en. |

## Example response

```json
{
    "data": {
        "carriers": [
            {
                "id": 1045,
                "code": "meinfernbus_flixbus",
                "name": "FlixBus",
                "modes": [
                    "bus"
                ],
                "logo_url": "https://static.omio.design/web/logos/31/meinfernbus_flixbus.png",
                "toc_codes": [],
                "iata_codes": [],
                "trip_count": 3,
                "cheapest_price": {
                    "currency": "EUR",
                    "amount_minor": 5600
                }
            },
            {
                "id": 44,
                "code": "air_france",
                "name": "Air France",
                "modes": [
                    "flight"
                ],
                "logo_url": "https://static.omio.design/web/logos/31/air_france.png",
                "toc_codes": [],
                "iata_codes": [
                    "af"
                ],
                "trip_count": 2,
                "cheapest_price": {
                    "currency": "EUR",
                    "amount_minor": 24500
                }
            },
            {
                "id": 112,
                "code": "deutsche_bahn",
                "name": "Deutsche Bahn",
                "modes": [
                    "train"
                ],
                "logo_url": "https://static.omio.design/web/logos/31/deutsche_bahn.png",
                "toc_codes": [
                    "2a",
                    "deutsche_bahn"
                ],
                "iata_codes": [],
                "trip_count": 1,
                "cheapest_price": {
                    "currency": "EUR",
                    "amount_minor": 13300
                }
            },
            {
                "id": 62,
                "code": "sas",
                "name": "Sas Airways",
                "modes": [
                    "flight"
                ],
                "logo_url": "https://static.omio.design/web/logos/31/sas.png",
                "toc_codes": [],
                "iata_codes": [
                    "sk"
                ],
                "trip_count": 1,
                "cheapest_price": {
                    "currency": "EUR",
                    "amount_minor": 82900
                }
            },
            {
                "id": 135,
                "code": "easyjet",
                "name": "easyJet",
                "modes": [
                    "flight"
                ],
                "logo_url": "https://static.omio.design/web/logos/31/easyjet.png",
                "toc_codes": [],
                "iata_codes": [
                    "u2"
                ],
                "trip_count": 1,
                "cheapest_price": {
                    "currency": "EUR",
                    "amount_minor": 37200
                }
            }
        ],
        "currency": "EUR",
        "search_id": "EEEEB9FDC8C6C4EA495BBAAB911D3E2D8",
        "search_meta": {
            "upstream_calls": 0
        },
        "booking_providers": [
            {
                "id": 100073,
                "name": "SNCF"
            },
            {
                "id": 100134,
                "name": "travelportconnect"
            },
            {
                "id": 100101,
                "name": "travelfusionconnect"
            },
            {
                "id": 100103,
                "name": "Deutsche Bahn"
            },
            {
                "id": 100104,
                "name": "Flixbus"
            },
            {
                "id": 100105,
                "name": "Eurostar"
            }
        ]
    },
    "meta": {
        "billable": true,
        "endpoint_family": "providers"
    },
    "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)