# How a journey reaches you

> How journeys reach a transfer company, by direct assignment or through the offer flow.

Section: Transfer companies · Last updated: 2026-11-15

This page explains how a journey booked by a partner ends up with your company, and what your
integration does from that moment until the journey is completed. Read it before the task guides in
this section.

## Two ways in

A traveller books a ride through a partner, for example from Amsterdam Airport Schiphol to a hotel in
the city. Transferz then gives the journey to a transfer company in one of two ways. Which one
applies to you is part of your agreement with Transferz; many companies receive journeys both ways.

**Direct assignment.** Transferz assigns the journey to one of your fleets straight away. You do not
have to do anything to get it. Transferz can also assign a journey to you by hand.

**Offer flow.** Transferz offers the journey to your company first. You accept or decline the offer
before its `expiry`. Only when you accept is the journey assigned to your fleet. An offer can also be
open to several companies at once; the first to accept gets the journey and the others see the offer
as `MISSED`.

Either way, the result is the same: the journey is assigned to your fleet and you receive
[`journeyFleetAssignedEvent`](https://developers.test.transferz.com/reference/webhooks/journey-assigned). From then on there is no
difference between the two flows.

| Step | Direct assignment                                                                                                     | Offer flow                                                                                                                              |
| ---- | --------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------- |
| 1    | —                                                                                                                     | You receive [`offerCreatedEvent`](https://developers.test.transferz.com/reference/webhooks/offer-created).                              |
| 2    | —                                                                                                                     | You [accept or decline](https://developers.test.transferz.com/guides/transfer-companies/accept-or-decline-offers) the offer.            |
| 3    | You receive [`journeyFleetAssignedEvent`](https://developers.test.transferz.com/reference/webhooks/journey-assigned). | After you accept, you receive [`journeyFleetAssignedEvent`](https://developers.test.transferz.com/reference/webhooks/journey-assigned). |
| 4    | You fetch the journey and plan it.                                                                                    | The same.                                                                                                                               |

An offer has an offer id and the journey has a journey id; they are different numbers. You use the
offer id only to accept or decline. After that, everything uses the `journeyId`.

## What you do with a journey

Once a journey is yours, your integration:

1. [Receives the journey by webhook](https://developers.test.transferz.com/guides/transfer-companies/receive-journeys-by-webhook) and
   fetches its details with [Get a journey](https://developers.test.transferz.com/reference/transfer-companies/get-journey).
2. [Assigns a driver and a vehicle](https://developers.test.transferz.com/guides/transfer-companies/assign-a-driver-and-vehicle). The
   journey moves from `CONFIRMED` to `PLANNED`.
3. [Reports progress](https://developers.test.transferz.com/guides/transfer-companies/report-journey-progress): driver underway, driver
   arrived, traveller on board, and the driver's position on the way. Or your drivers use the
   Transferz Driver App, which does this for you.
4. [Completes the journey](https://developers.test.transferz.com/guides/transfer-companies/complete-a-journey) after the drop-off.

Along the way you may also need to:

- [handle changes and cancellations](https://developers.test.transferz.com/guides/transfer-companies/handle-changes-and-cancellations)
  that Transferz sends you;
- [report a no-show](https://developers.test.transferz.com/guides/transfer-companies/report-a-no-show-or-delay) with evidence;
- [update pickup information](https://developers.test.transferz.com/guides/transfer-companies/update-pickup-information) for shared
  journeys;
- [report that the host met the traveller](https://developers.test.transferz.com/guides/transfer-companies/meet-and-greet) for meet and
  greet journeys;
- [look up and search journeys](https://developers.test.transferz.com/guides/transfer-companies/look-up-and-search-journeys) to keep your
  planning in sync.

## The statuses you see

A journey's `status` tells you where it is. As a transfer company you see these:

| Status                 | What it means for you                          | Who sets it                                                  |
| ---------------------- | ---------------------------------------------- | ------------------------------------------------------------ |
| `CONFIRMED`            | The journey is yours. It still needs a driver. | Transferz                                                    |
| `PLANNED`              | A driver is assigned.                          | Transferz, when you assign a driver                          |
| `DRIVER_UNDERWAY`      | The driver is on the way to the pickup.        | You or the Driver App                                        |
| `DRIVER_ARRIVED`       | The driver is at the pickup.                   | You, the Driver App, or Transferz from the driver's position |
| `JOURNEY_IN_PROGRESS`  | The traveller is on board.                     | You or the Driver App                                        |
| `COMPLETED`            | The traveller was dropped off.                 | You, the Driver App, or Transferz from the driver's position |
| `CANCELLED_FREE`       | Cancelled; you are not paid for it.            | Transferz                                                    |
| `CANCELLED_WITH_COSTS` | Cancelled; you are paid for it.                | Transferz                                                    |

Journeys in the early statuses (`NOT_PAID`, `AWAITING_APPROVAL`, `PENDING`) are not yet yours, and you
receive no status events for them. `COMPLETED` and the two cancelled statuses are final. All values
are explained in [Constants](https://developers.test.transferz.com/guides/essentials/constants#journey-status).

## Before you start

You need:

- a staging account and an API key; see [Getting started](https://developers.test.transferz.com/guides/transfer-companies/getting-started);
- an HTTPS webhook endpoint registered in the [workspace](https://developers.test.transferz.com/workspace); see
  [Webhooks](https://developers.test.transferz.com/guides/essentials/webhooks);
- a test journey; the [workspace](https://developers.test.transferz.com/workspace) books one for you, see
  [Test data on staging](https://developers.test.transferz.com/guides/essentials/test-data#transfer-companies-get-a-test-journey).

Then continue with [Receive journeys by webhook](https://developers.test.transferz.com/guides/transfer-companies/receive-journeys-by-webhook).

## Related

### Endpoints

- [GET Get journey](https://developers.test.transferz.com/reference/transfer-companies/get-journey) (`GET /journeys/{id}`)
- [GET Search journeys](https://developers.test.transferz.com/reference/transfer-companies/search-journeys) (`GET /journeys`)
- [GET Get available offers](https://developers.test.transferz.com/reference/transfer-companies/list-available-offers) (`GET /offers/available/all`)
- [POST Accept offer](https://developers.test.transferz.com/reference/transfer-companies/accept-offer) (`POST /offers/{id}/accept`)

### Walk-through steps

- [Receive a journey](https://developers.test.transferz.com/walkthrough/transfer-company/receive-a-journey)
- [Offer flow](https://developers.test.transferz.com/walkthrough/transfer-company/offer-flow)
