Distribusion

Welcome to the Distribusion Retailer API.

The Distribusion API allows online channels of all kinds to access and distribute ground transportation in the simplest way. Distribusion’s portfolio of inventory is fully standardised and encompasses intercity bus, rail, ferry, and airport transfer services from all around the world.

To request a demo API key or receive an overview of the accessible inventory, please reach out to us at [partner@distribusion.com](https://mailto:partner@distribusion.com) and one of our Partnership Managers will be happy to get you started.

This section provides an overview of relevant guidelines and key concepts that will enable you to get started with the Distribusion Retailer API.

More details at [https://api.distribusion.com/doc/index#retailer-api.](https://api.distribusion.com/doc/index#retailer-api.)

Getting Started

Basic Integration

Enterprise Features

Other Concepts

API Endpoints

📣 What's New

Errors

Booking Engine

Intro

Integration Types

Search SDK

Examples of Booking Engines

Custom Domain

Analytics

Languages

Agent Counter

Connectivity Services

Invoicing and Payments

Dictionary

Default

Distribusion Docs

Explore the Distribusion Documentation Portal for API guides, integration tutorials, and developer tools to connect with global ground transportation solutions seamlessly.

Demo

Production

Accreditation

Advanced Pricing Insights

AI Tools

Alternative Location Identifiers

Amendments

/amendments/{amendment_id}

/amendments/confirm

/amendments/create

Ancillaries

API Authentication

Rate Limiting & Usage Policy

/price-insights/price-hints

/price-insights/price-forecast

/price-insights/calendar

/price-insights/calendar/return

Bookings

/bookings

/bookings/{booking_id}

/bookings/{booking_id}/conditions

/bookings/{booking_id}/tickets

/bookings/create

Cancellations

/cancellations/conditions

/cancellations/create

Cards

/cards

Connections

/connections/find

/connections/seats

/connections/vacancy

Marketing Carriers

/marketing_carriers

/marketing_carriers/{marketing_carrier_id}

/marketing_carriers/{marketing_carrier_id}/booking/schema

/marketing_carriers/{marketing_carrier_id}/gtfs

/marketing_carriers/{marketing_carrier_id}/stations

Post-Sales AI Bot

/post-sales-bot/chat

/post-sales-bot/chat-init

/post-sales-bot/chat/stream

Reservations

/reservations/cancel

/reservations/confirm

/reservations/create

/reservations/{reservation_id}

Stations, Areas & Cities

/areas

/cities

/connected_stations

/stations

/stations/{station_code}

Booking Confirmation

Cancel Booking

Checking Price & Vacancy

Checking Reservation Status

Confirming Reservation

Creating Reservation

Flow Overview

Preparing Metadata

Searching for Trips

Selecting Seats

MCP Server

Retailer Agent

Discount Cards

Emissions Data

GTFS

Negotiated & Corporate Fares

Real Time

Suggestion Service

Virtual Interlining

Carrier Accreditation

Accreditation Criteria

General Accreditation

Demo Environment

Postman

Preview Distribusion Content

Asynchronous Cancellations

Fees

Booking Fees

Convenience Fees

Markup Fees

Cancellation & Refund Policies

Carrier Cancellations

Terms & Conditions

Currencies

Custom Fields

Dynamic Passenger Details

Fare Classes

Fare Features & Amenities

Geo Coordinate Search

IATA and UIC Codes Search

Journey Types

Limited Day Content

Operating Carriers

Required Passenger Detail

Passenger Types

Ticket Delivery

Ticket Types

Ticket Validity

Timezones

Webhooks

Checkout Only Integration

Full Search & Book Integration

Partial Integration

### Description

This endpoint delivers all of Distribusion’s stations and provides the detailed information required for mapping these stations in your system. We recommend calling this API on a weekly basis to detect newly mapped stations and add them to your system.

**Why onboarding of meta data is important?**

In order for users to search for trips, the meta data related to marketing carriers and stations will need to be retrieved and stored locally, which can be achieved by making use of the dedicated [/marketing_carriers/{marketing_carrier_id}](https://lively-space-811588.postman.co/workspace/f46e13d3-12d7-41eb-86e4-45523c4a451d/request/18003295-4b7f6a67-704f-4c88-9f76-99fd6837d089?ctx=documentation) and [/stations](https://lively-space-811588.postman.co/workspace/f46e13d3-12d7-41eb-86e4-45523c4a451d/request/18003295-d273a8e6-5331-4c9f-a515-433384136d05?ctx=documentation), [/cities](https://lively-space-811588.postman.co/workspace/f46e13d3-12d7-41eb-86e4-45523c4a451d/request/18003295-48bf5070-88e4-4db9-90b3-14916e88294f?ctx=documentation), [/areas](https://lively-space-811588.postman.co/workspace/f46e13d3-12d7-41eb-86e4-45523c4a451d/request/18003295-8043d591-3b37-4096-85bc-df7e7f862a54?ctx=documentation) endpoints.

Once the stations and marketing carriers have been onboarded, trips can be searched by using the [/connections/find](https://lively-space-811588.postman.co/workspace/f46e13d3-12d7-41eb-86e4-45523c4a451d/request/18003295-7d7b6f93-3ca8-45fc-a7f6-bba7f0346667?ctx=documentation) endpoint.

The Distribusion API enables you to search for trips on city, airport, and station level, flexibly catering to what the user chooses to input.

**Station Codes**

Distribusion standardises station and city data across the entire ground transportation industry, the same way in which IATA does in the flight industry.

Our station codes are designed to represent specific locations using a set of 8 capital letters that make it easy for you to identify and, where applicable, assign them to existing location entities within your own system.

The structure of our station codes follows a simple logic:

- The first two letters represent the country in which the station is located
- The next three represent the city in which the station is located
- The last three letters more precisely represent the location of the station
    

**Example**

GB (Great Britain) + LON (London) + VSA (Victoria station) = GBLONVSA

**Station types**

To facilitate the distribution of different modes of ground transportation, which are clearly marked within the `station_type` parameter for each station in the [/stations](https://lively-space-811588.postman.co/workspace/f46e13d3-12d7-41eb-86e4-45523c4a451d/request/18003295-d273a8e6-5331-4c9f-a515-433384136d05?ctx=documentation) endpoint, Distribusion supports four station types:

- Bus station: bus_station
- Train station: train_station
- Ferry station: ferry_station
- Tram station: tram_station
    

**Get Started**

To get started with the onboarding and mapping of Distribusion stations, make a request to [/stations](https://lively-space-811588.postman.co/workspace/f46e13d3-12d7-41eb-86e4-45523c4a451d/request/18003295-d273a8e6-5331-4c9f-a515-433384136d05?ctx=documentation), which returns all the necessary data on stations including:

- Type
- Name
- Address
- Description
- Geo coordinates
- Time zone
- City
- Area, where applicable
    

**Other Endpoints**

In case you already know which marketing carriers are of interest to you, please refer to these additional endpoints:

- The [/marketing_carriers/{marketing_carrier_id}/stations](https://lively-space-811588.postman.co/workspace/f46e13d3-12d7-41eb-86e4-45523c4a451d/request/18003295-ab73a723-5736-458f-b67a-f556d42fdb5c?ctx=documentation) endpoint allows you to retrieve a list of all stations used by a specific marketing carrier.
- For even more precision, take a look at the [/connected_stations](https://lively-space-811588.postman.co/workspace/f46e13d3-12d7-41eb-86e4-45523c4a451d/request/18003295-430b380c-f67c-4366-baa0-f058dcb41fd4?ctx=documentation) endpoint, which shows you the stations that are connected as bookable trips. This endpoint is filterable by carrier code.
    

**Note**

As Distribusion continuously updates and extends its coverage of carriers, stations and routes, we recommend automatically checking for new stations at least twice per week.

### More Info

- **Full API integration**
    - [Basic workflow](https://api.distribusion.com/doc/full-api-integration#basic-workflow)
- **Key Concepts**
    - [Onboarding metadata](https://api.distribusion.com/doc/key-concepts#id1)
        - [Station, city, and area codes](https://api.distribusion.com/doc/key-concepts#id1)
    - [Currencies and locales](https://api.distribusion.com/doc/key-concepts#currencies-and-locales)
- **Endpoints**
    - [GET /retailers/v4/stations](https://api.distribusion.com/doc/api#get-retailers-v4-stations-stations-index)

### Description

This endpoint delivers data about specific stations.

**Why onboarding of meta data is important?**

In order for users to search for trips, the meta data related to marketing carriers and stations will need to be retrieved and stored locally, which can be achieved by making use of the dedicated [/marketing_carriers/{marketing_carrier_id}](https://lively-space-811588.postman.co/workspace/f46e13d3-12d7-41eb-86e4-45523c4a451d/request/18003295-4b7f6a67-704f-4c88-9f76-99fd6837d089?ctx=documentation) and [/stations](https://lively-space-811588.postman.co/workspace/f46e13d3-12d7-41eb-86e4-45523c4a451d/request/18003295-d273a8e6-5331-4c9f-a515-433384136d05?ctx=documentation), [/cities](https://lively-space-811588.postman.co/workspace/f46e13d3-12d7-41eb-86e4-45523c4a451d/request/18003295-48bf5070-88e4-4db9-90b3-14916e88294f?ctx=documentation), [/areas](https://lively-space-811588.postman.co/workspace/f46e13d3-12d7-41eb-86e4-45523c4a451d/request/18003295-8043d591-3b37-4096-85bc-df7e7f862a54?ctx=documentation) endpoints.

Once the stations and marketing carriers have been onboarded, trips can be searched by using the [/connections/find](https://lively-space-811588.postman.co/workspace/f46e13d3-12d7-41eb-86e4-45523c4a451d/request/18003295-7d7b6f93-3ca8-45fc-a7f6-bba7f0346667?ctx=documentation) endpoint.

**Station Codes**

Distribusion standardises station and city data across the entire ground transportation industry, the same way in which IATA does in the flight industry.

Our station codes are designed to represent specific locations using a set of 8 capital letters that make it easy for you to identify and, where applicable, assign them to existing location entities within your own system.

The structure of our station codes follows a simple logic:

- The first two letters represent the country in which the station is located
- The next three represent the city in which the station is located
- The last three letters more precisely represent the location of the station
    

**Example**

GB (Great Britain) + LON (London) + VSA (Victoria station) = GBLONVSA

**Station types**

To facilitate the distribution of different modes of ground transportation, which are clearly marked within the `station_type` parameter for each station in the [/stations](https://lively-space-811588.postman.co/workspace/f46e13d3-12d7-41eb-86e4-45523c4a451d/request/18003295-d273a8e6-5331-4c9f-a515-433384136d05?ctx=documentation) endpoint, Distribusion supports four station types:

- Bus station: bus_station
- Train station: train_station
- Ferry station: ferry_station
- Tram station: tram_station
    

**Get Started**

To get started with the onboarding and mapping of Distribusion stations, make a request to [/stations](https://lively-space-811588.postman.co/workspace/f46e13d3-12d7-41eb-86e4-45523c4a451d/request/18003295-d273a8e6-5331-4c9f-a515-433384136d05?ctx=documentation), which returns all the necessary data on stations including:

- Type
- Name
- Address
- Description
- Geo coordinates
- Time zone
- City
- Area, where applicable
    

**Other Endpoints**

In case you already know which marketing carriers are of interest to you, please refer to these additional endpoints:

- The [/marketing_carriers/{marketing_carrier_id}/stations](https://lively-space-811588.postman.co/workspace/f46e13d3-12d7-41eb-86e4-45523c4a451d/request/18003295-ab73a723-5736-458f-b67a-f556d42fdb5c?ctx=documentation) endpoint allows you to retrieve a list of all stations used by a specific marketing carrier.
- For even more precision, take a look at the [/connected_stations](https://lively-space-811588.postman.co/workspace/f46e13d3-12d7-41eb-86e4-45523c4a451d/request/18003295-430b380c-f67c-4366-baa0-f058dcb41fd4?ctx=documentation) endpoint, which shows you the stations that are connected as bookable trips. This endpoint is filterable by carrier code.
    

**Note**

As Distribusion continuously updates and extends its coverage of carriers, stations and routes, we recommend automatically checking for new stations at least twice per week.

### More Info

- **Full API integration**
    - [Basic workflow](https://api.distribusion.com/doc/full-api-integration#basic-workflow)
- **Key Concepts**
    - [Onboarding metadata](https://api.distribusion.com/doc/key-concepts#id1)
        - [Station, city, and area codes](https://api.distribusion.com/doc/key-concepts#id1)
    - [Currencies and locales](https://api.distribusion.com/doc/key-concepts#currencies-and-locales)
- **Endpoints**
    - [GET /retailers/v4/stations](https://api.distribusion.com/doc/api#get-retailers-v4-stations-stations-index)

### Description

This endpoint can be used to retrieve all station pairs that are available in Distribusion’s database as bookable origin-destination combinations.

Requests to this endpoint can be filtered to identify connected station pairs for one or multiple marketing carriers.

**Why onboarding of meta data is important?**

In order for users to search for trips, the meta data related to marketing carriers and stations will need to be retrieved and stored locally, which can be achieved by making use of the dedicated [/marketing_carriers/{marketing_carrier_id}](https://lively-space-811588.postman.co/workspace/f46e13d3-12d7-41eb-86e4-45523c4a451d/request/18003295-4b7f6a67-704f-4c88-9f76-99fd6837d089?ctx=documentation) and [/stations](https://lively-space-811588.postman.co/workspace/f46e13d3-12d7-41eb-86e4-45523c4a451d/request/18003295-d273a8e6-5331-4c9f-a515-433384136d05?ctx=documentation), [/cities](https://lively-space-811588.postman.co/workspace/f46e13d3-12d7-41eb-86e4-45523c4a451d/request/18003295-48bf5070-88e4-4db9-90b3-14916e88294f?ctx=documentation), [/areas](https://lively-space-811588.postman.co/workspace/f46e13d3-12d7-41eb-86e4-45523c4a451d/request/18003295-8043d591-3b37-4096-85bc-df7e7f862a54?ctx=documentation) endpoints.

Once the stations and marketing carriers have been onboarded, trips can be searched by using the [/connections/find](https://lively-space-811588.postman.co/workspace/f46e13d3-12d7-41eb-86e4-45523c4a451d/request/18003295-7d7b6f93-3ca8-45fc-a7f6-bba7f0346667?ctx=documentation) endpoint.

The Distribusion API enables you to search for trips on city, airport, and station level, flexibly catering to what the user chooses to input.

**Pagination**

The pagination parameters can be used for scrolling when there are more than 10,000 results. The parameters support forward (page\[after\]) scrolling. This requires the request to be split into two or more requests.

If a response is over 10,000 results long, it includes a links.next parameter, which specifies the link that should be inserted in page\[after\] for the subsequent request to proceed to the next page.

**Station Codes**

Distribusion standardises station and city data across the entire ground transportation industry, the same way in which IATA does in the flight industry.

Our station codes are designed to represent specific locations using a set of 8 capital letters that make it easy for you to identify and, where applicable, assign them to existing location entities within your own system.

The structure of our station codes follows a simple logic:

- The first two letters represent the country in which the station is located
- The next three represent the city in which the station is located
- The last three letters more precisely represent the location of the station
    

**Example**

GB (Great Britain) + LON (London) + VSA (Victoria station) = GBLONVSA

**Other Endpoints**

In case you already know which marketing carriers are of interest to you, please refer to the [/marketing_carriers/{marketing_carrier_id}/stations](https://lively-space-811588.postman.co/workspace/f46e13d3-12d7-41eb-86e4-45523c4a451d/request/18003295-ab73a723-5736-458f-b67a-f556d42fdb5c?ctx=documentation) endpoint allows you to retrieve a list of all stations used by a specific marketing carrier.

**Note**

As Distribusion continuously updates and extends its coverage of carriers, stations and routes, we recommend automatically checking for new stations at least twice per week.

### More Info

- **Full API integration**
    - [Basic workflow](https://api.distribusion.com/doc/full-api-integration#basic-workflow)
- **Key Concepts**
    - [Onboarding metadata](https://api.distribusion.com/doc/key-concepts#id1)
        - [Station, city, and area codes](https://api.distribusion.com/doc/key-concepts#id1)
    - [Currencies and locales](https://api.distribusion.com/doc/key-concepts#currencies-and-locales)
- **Endpoints**
    
    - [GET /retailers/v4/connected_stations](https://api.distribusion.com/doc/api#get-retailers-v4-connected-stations-connected-stations-index)

### Description

This endpoint delivers all of Distribusion’s areas and provides the detailed information required for mapping these areas in your system. We recommend calling this API on a weekly basis to detect newly mapped areas and add them to your system.

**Why onboarding of meta data is important?**

In order for users to search for trips, the meta data related to marketing carriers and stations will need to be retrieved and stored locally, which can be achieved by making use of the dedicated [/marketing_carriers/{marketing_carrier_id}](https://lively-space-811588.postman.co/workspace/f46e13d3-12d7-41eb-86e4-45523c4a451d/request/18003295-4b7f6a67-704f-4c88-9f76-99fd6837d089?ctx=documentation) and [/stations](https://lively-space-811588.postman.co/workspace/f46e13d3-12d7-41eb-86e4-45523c4a451d/request/18003295-d273a8e6-5331-4c9f-a515-433384136d05?ctx=documentation), [/cities](https://lively-space-811588.postman.co/workspace/f46e13d3-12d7-41eb-86e4-45523c4a451d/request/18003295-48bf5070-88e4-4db9-90b3-14916e88294f?ctx=documentation), [/areas](https://lively-space-811588.postman.co/workspace/f46e13d3-12d7-41eb-86e4-45523c4a451d/request/18003295-8043d591-3b37-4096-85bc-df7e7f862a54?ctx=documentation) endpoints.

Once the stations and marketing carriers have been onboarded, trips can be searched by using the [/connections/find](https://lively-space-811588.postman.co/workspace/f46e13d3-12d7-41eb-86e4-45523c4a451d/request/18003295-7d7b6f93-3ca8-45fc-a7f6-bba7f0346667?ctx=documentation) endpoint.

The Distribusion API enables you to search for trips on city, airport, and station level, flexibly catering to what the user chooses to input.

**Area Codes**

Besides grouping stations by cities and countries, Distribusion also provides an area grouping that unites all the stations that belong to the same airport.

Each area consists of a 7-letter-code, following this logic:

- The first two letters represent the country in which the airport is located
- The next three represent the city in which the airport is located
- The last two letters more precisely represent the location of the airport
    

**Example**

- Area
    - London Heathrow Airport (GBLONLA)
- Stations belonging to this area
    - London Heathrow Airport Terminal 3 (GBLONAHT)
    - London Heathrow Airport Terminal 4 (GBLONHAI)
    - London Heathrow Airport Terminal 5 (GBLONHAR)

**Note**

As Distribusion continuously updates and extends its coverage of carriers, stations and routes, we recommend automatically checking for new stations at least twice per week.

### More Info

- **Full API integration**
    - [Basic workflow](https://api.distribusion.com/doc/full-api-integration#basic-workflow)
- **Key Concepts**
    - [Onboarding metadata](https://api.distribusion.com/doc/key-concepts#id1)
        - [Station, city, and area codes](https://api.distribusion.com/doc/key-concepts#id1)
    - [Currencies and locales](https://api.distribusion.com/doc/key-concepts#currencies-and-locales)
- **Endpoints**
    
    - [GET /retailers/v4/areas](https://api.distribusion.com/doc/api#areas)

### Description

This endpoint delivers all of Distribusion’s cities and provides the detailed information required for mapping these cities in your system. We recommend calling this API on a weekly basis to detect newly mapped cities and add them to your system.

**Why onboarding of meta data is important?**

In order for users to search for trips, the meta data related to marketing carriers and stations will need to be retrieved and stored locally, which can be achieved by making use of the dedicated [/marketing_carriers/{marketing_carrier_id}](https://lively-space-811588.postman.co/workspace/f46e13d3-12d7-41eb-86e4-45523c4a451d/request/18003295-4b7f6a67-704f-4c88-9f76-99fd6837d089?ctx=documentation) and [/stations](https://lively-space-811588.postman.co/workspace/f46e13d3-12d7-41eb-86e4-45523c4a451d/request/18003295-d273a8e6-5331-4c9f-a515-433384136d05?ctx=documentation), [/cities](https://lively-space-811588.postman.co/workspace/f46e13d3-12d7-41eb-86e4-45523c4a451d/request/18003295-48bf5070-88e4-4db9-90b3-14916e88294f?ctx=documentation), [/areas](https://lively-space-811588.postman.co/workspace/f46e13d3-12d7-41eb-86e4-45523c4a451d/request/18003295-8043d591-3b37-4096-85bc-df7e7f862a54?ctx=documentation) endpoints.

Once the stations and marketing carriers have been onboarded, trips can be searched by using the [/connections/find](https://lively-space-811588.postman.co/workspace/f46e13d3-12d7-41eb-86e4-45523c4a451d/request/18003295-7d7b6f93-3ca8-45fc-a7f6-bba7f0346667?ctx=documentation) endpoint.

The Distribusion API enables you to search for trips on city, airport, and station level, flexibly catering to what the user chooses to input.

**City Codes**

Distribusion also provides harmonised location codes at city level that unite all stations within a certain city.

City codes consist of 5 letters according to the following logic:

- The first two letters represent the country in which the city is located
- The next three represent the city code
    

**Example**

- City
    - London (GBLON)
- Stations belonging to this area:
    - London Victoria Coach Station(GBLONVSA)
    - London Park Inn Heathrow (GBLONPIH)
    - London Lewisham (GBLONLEW)

**Note**

As Distribusion continuously updates and extends its coverage of carriers, stations and routes, we recommend automatically checking for new stations at least twice per week.

### More Info

- **Full API integration**
    - [Basic workflow](https://api.distribusion.com/doc/full-api-integration#basic-workflow)
- **Key Concepts**
    - [Onboarding metadata](https://api.distribusion.com/doc/key-concepts#id1)
        - [Station, city, and area codes](https://api.distribusion.com/doc/key-concepts#id1)
    - [Currencies and locales](https://api.distribusion.com/doc/key-concepts#currencies-and-locales)
- **Endpoints**
    
    - [GET /retailers/v4/cities](https://api.distribusion.com/doc/api#cities)

<p class="slate-p " >The Stations, Areas &amp; Cities section of the Distribusion API provides users with access to data related to transportation hubs, geographical areas, and urban locations. With this section, users can retrieve information about specific stations, browse through different areas, and discover various cities to enhance their travel booking and planning experiences.</p><p class="slate-p " ></p>

The Stations, Areas & Cities section of the Distribusion API provides users with access to data related to transportation hubs, geographical areas, and urban locations. With this section, users can retrieve information about specific stations, browse through different areas, and discover various cities to enhance their travel booking and planning experiences.

Sections

Stations, Areas & Cities

What made this section helpful for you?

What made this section unhelpful for you?

On this page

Sections

Stations, Areas & Cities

What made this section helpful for you?

What made this section unhelpful for you?

On this page

Ask an AI

Code with AI