# Transferz Developer Portal > Documentation for integrating with the Transferz APIs: partners book airport and city transfers, transfer companies receive and run the journeys. Everything in this portal works against the Transferz staging environment. Every page is available as Markdown by adding `.md` to its address. Full documentation in one file: [partners](https://developers.test.transferz.com/llms-full-partner.txt), [transfer companies](https://developers.test.transferz.com/llms-full-transfer-company.txt). ## For everyone ### Guides - [Environments and base URLs](https://developers.test.transferz.com/guides/get-started/environments.md): The staging and production environments, and the base URL of each Transferz API. - [Authentication](https://developers.test.transferz.com/guides/get-started/authentication.md): Create an API key and send it in the X-API-Key header with every request. - [Glossary](https://developers.test.transferz.com/guides/get-started/glossary.md): The terms used across the Transferz APIs and this portal, from booking to meeting point. - [Webhooks](https://developers.test.transferz.com/guides/essentials/webhooks.md): Receive events from Transferz, verify their signature, acknowledge them, and handle retries, order and duplicates. - [Errors](https://developers.test.transferz.com/guides/essentials/errors.md): How the Transferz APIs report errors, and the cause and remedy of each error code. - [Conventions](https://developers.test.transferz.com/guides/essentials/conventions.md): Dates and time zones, IDs, pagination, request IDs and rate limits across the Transferz APIs. - [Constants](https://developers.test.transferz.com/guides/essentials/constants.md): Every journey status, vehicle category, add-on, cancellation reason and decline reason, with what each value means. - [Versioning and deprecation](https://developers.test.transferz.com/guides/essentials/versioning.md): How the Transferz APIs change over time, how deprecated fields are marked, and how to stay compatible. - [Test data on staging](https://developers.test.transferz.com/guides/essentials/test-data.md): How to get test journeys and bookings on staging, and how to trigger each scenario you need to test. - [Going live](https://developers.test.transferz.com/guides/essentials/going-live.md): What to check before launch, the go-live checklist, and whom to contact before and after launch. ### API reference - [Webhook events: Journey status changed](https://developers.test.transferz.com/reference/webhooks/journey-status-changed.md): A journey moved to a new status, for example from PENDING to CONFIRMED or to cancelled. - [Errors: NULL_VALUE](https://developers.test.transferz.com/reference/errors/null-value.md): A required value is missing - [Errors: BLANK_VALUE](https://developers.test.transferz.com/reference/errors/blank-value.md): A value is empty - [Errors: VALUE_TOO_LONG](https://developers.test.transferz.com/reference/errors/value-too-long.md): A value is too long - [Errors: NUMBER_NOT_IN_ALLOWED_RANGE](https://developers.test.transferz.com/reference/errors/number-not-in-allowed-range.md): A number is out of range - [Errors: EMAIL_INVALID](https://developers.test.transferz.com/reference/errors/email-invalid.md): The email address is not valid - [Errors: UNKNOWN](https://developers.test.transferz.com/reference/errors/unknown.md): Unexpected error - [Errors: INSUFFICIENT_PERMISSIONS](https://developers.test.transferz.com/reference/errors/insufficient-permissions.md): Not allowed for this account - [Errors: DELETED_ENTITY_MUTATION_ATTEMPT](https://developers.test.transferz.com/reference/errors/deleted-entity-mutation-attempt.md): The object was deleted - [Errors: BAD_CREDENTIALS](https://developers.test.transferz.com/reference/errors/bad-credentials.md): Key or token not valid - [Errors: LOCKED_USER_ACCOUNT](https://developers.test.transferz.com/reference/errors/locked-user-account.md): The account is not active - [Errors: API_KEY_GENERATION_DISABLED](https://developers.test.transferz.com/reference/errors/api-key-generation-disabled.md): API keys are disabled for this user - [Errors: API_KEY_LIMIT_REACHED](https://developers.test.transferz.com/reference/errors/api-key-limit-reached.md): Too many API keys - [Errors: PASSWORD_EXPIRED](https://developers.test.transferz.com/reference/errors/password-expired.md): The password has expired ### Changelog - [Changelog](https://developers.test.transferz.com/changelog.md): Dated changes to the Transferz APIs, per audience. - [Developer portal launched](https://developers.test.transferz.com/changelog/developer-portal-launched.md): 2026-11-15: Developer portal launched ### AI tools - [Connect your coding agent (MCP)](https://developers.test.transferz.com/mcp-setup.md): Add the portal's hosted MCP server (/mcp) to Claude Code, Cursor, VS Code, Windsurf or Codex: search the docs and read endpoints from your editor. ## For partners ### Guides - [Getting started as a partner](https://developers.test.transferz.com/guides/partners/getting-started.md): Make your first call to the Transferz staging API from your own system. You need the onboarding email from Transferz. About 10 minutes. - [How a booking works](https://developers.test.transferz.com/guides/partners/how-a-booking-works.md): The lifecycle of a partner booking, from quote to completed journey. - [Request quotes](https://developers.test.transferz.com/guides/partners/request-quotes.md): Request quotes for a transfer, including return trips and flight lookup. - [Suggest a pickup time](https://developers.test.transferz.com/guides/partners/suggest-a-pickup-time.md): Ask Transferz for a suggested pickup time based on the traveller's flight. - [Create a booking](https://developers.test.transferz.com/guides/partners/create-a-booking.md): Turn a quote into a booking with traveller details and your own reference. - [Pay for a booking](https://developers.test.transferz.com/guides/partners/pay-for-a-booking.md): Pay for a booking by invoice, payment link or Stripe Connect. - [Follow a journey](https://developers.test.transferz.com/guides/partners/follow-a-journey.md): Follow a journey's status, driver and vehicle by webhook or polling, and get its voucher. - [Change a journey](https://developers.test.transferz.com/guides/partners/change-a-journey.md): Change a journey's details or add-ons, and settle any extra payment. - [Cancel a journey or a booking](https://developers.test.transferz.com/guides/partners/cancel-a-journey-or-booking.md): Cancel one journey or a whole booking, with or without cancellation charges. ### API reference - [Partners API: Request quotes (POST /quotes)](https://developers.test.transferz.com/reference/partners/request-quotes.md): Retrieves a set of quotes for the provided input parameters - [Partners API: Suggest pickup time (POST /quotes/suggest-pickup-time)](https://developers.test.transferz.com/reference/partners/suggest-pickup-time.md): Suggests a pickup time based on flight arrival or departure to be used in a subsequent quote request - [Partners API: Create booking (POST /bookings)](https://developers.test.transferz.com/reference/partners/create-booking.md): Creates a booking using one or more provided quotes - [Partners API: Pay by Stripe Connect (POST /bookings/{id}/pay-by-stripe-connect)](https://developers.test.transferz.com/reference/partners/pay-booking-by-stripe-connect.md): Pays for a booking using a Stripe Connect payment intent - [Partners API: Pay by invoice (POST /bookings/{id}/pay-by-invoice)](https://developers.test.transferz.com/reference/partners/pay-booking-by-invoice.md): Pays for a booking on invoice (only supported for selected partners) - [Partners API: Generate payment link (POST /bookings/{id}/generate-payment-link)](https://developers.test.transferz.com/reference/partners/generate-booking-payment-link.md): Generates a payment link for a previously generated booking - [Partners API: Cancel booking (POST /bookings/{id}/cancel)](https://developers.test.transferz.com/reference/partners/cancel-booking.md): Cancels the journeys in a previously created booking - [Partners API: Get booking by id (GET /bookings/{id})](https://developers.test.transferz.com/reference/partners/get-booking.md): Retrieves a previously created booking including associated journeys - [Partners API: Create journey change (POST /journeys/{journeyId}/changes)](https://developers.test.transferz.com/reference/partners/create-journey-change.md): Creates a change to an existing journey and applies it if no additional payment is required - [Partners API: Pay journey change on invoice (POST /journeys/{journeyId}/changes/{changeId}/pay-by-invoice)](https://developers.test.transferz.com/reference/partners/pay-journey-change-by-invoice.md): Pays for the provided journey change on invoice, after which it will be applied - [Partners API: Generate journey change payment link (POST /journeys/{journeyId}/changes/{changeId}/generate-payment-link)](https://developers.test.transferz.com/reference/partners/generate-journey-change-payment-link.md): Generates a payment link to perform the additional payment for the journey change - [Partners API: Cancel journey (POST /journeys/{journeyId}/cancel)](https://developers.test.transferz.com/reference/partners/cancel-journey.md): Cancels a previously created journey - [Partners API: Get journey by id (GET /journeys/{journeyId})](https://developers.test.transferz.com/reference/partners/get-journey.md): Retrieves a previously created journey - [Partners API: Get journey voucher (GET /journeys/{journeyId}/voucher)](https://developers.test.transferz.com/reference/partners/get-journey-voucher.md): Retrieves a PDF voucher for the given journey. If a voucher is not yet available the endpoint will return a status 204. If the voucher is available it will return a status 303 with the Location header pointing to the download location. If the journey is modified a new voucher will be issued - be sure to obtain the new voucher. - [Partners API: Get available add-ons (GET /journeys/{journeyId}/available-addons)](https://developers.test.transferz.com/reference/partners/get-available-add-ons.md): Retrieves a list of add-ons available to be added through journey changes for the current journey - [Partners API: Search flights (GET /flights/search)](https://developers.test.transferz.com/reference/partners/search-flights.md): Retrieves a list of flights for the provided parameters. At minimum the arrival and departure airport should be specified, along with an arrival or departure date. - [Partners API: Resolve flight (GET /flights/resolve)](https://developers.test.transferz.com/reference/partners/resolve-flight.md): Resolves a flight using the flight designator and arrival or departure date. - [Webhook events: Driver assigned](https://developers.test.transferz.com/reference/webhooks/driver-assigned.md): The transfer company assigned a driver to the journey. - [Webhook events: Driver position updated](https://developers.test.transferz.com/reference/webhooks/driver-position-updated.md): The driver of the journey reported a new position. - [Webhook events: Vehicle assigned](https://developers.test.transferz.com/reference/webhooks/vehicle-assigned.md): The transfer company assigned a vehicle to the journey's driver. - [Errors: INVALID_SIZE](https://developers.test.transferz.com/reference/errors/invalid-size.md): A value is too short or too long - [Errors: NOT_NULL_VALUE](https://developers.test.transferz.com/reference/errors/not-null-value.md): A value must be left out - [Errors: INCORRECT_LENGTH_OR_CHARACTERS](https://developers.test.transferz.com/reference/errors/incorrect-length-or-characters.md): A value has the wrong length or characters - [Errors: DATE_NOT_IN_ALLOWED_RANGE](https://developers.test.transferz.com/reference/errors/date-not-in-allowed-range.md): A date is out of range - [Errors: TIME_NOT_IN_ALLOWED_RANGE](https://developers.test.transferz.com/reference/errors/time-not-in-allowed-range.md): A time is out of range - [Errors: LOCATION_NOT_FOUND](https://developers.test.transferz.com/reference/errors/location-not-found.md): Location could not be resolved - [Errors: ADDRESS_NOT_RESOLVED](https://developers.test.transferz.com/reference/errors/address-not-resolved.md): Address could not be resolved - [Errors: NO_HUB_SELECTED](https://developers.test.transferz.com/reference/errors/no-hub-selected.md): Neither origin nor destination is a hub - [Errors: ORIGIN_AND_DESTINATION_SAME](https://developers.test.transferz.com/reference/errors/origin-and-destination-same.md): Origin and destination are the same - [Errors: INVALID_LOCATION](https://developers.test.transferz.com/reference/errors/invalid-location.md): Location is not valid for this request - [Errors: NO_VEHICLE_CATEGORIES_AVAILABLE](https://developers.test.transferz.com/reference/errors/no-vehicle-categories-available.md): No vehicle categories available - [Errors: CURRENCY_CONVERSION_ERROR](https://developers.test.transferz.com/reference/errors/currency-conversion-error.md): Currency not supported - [Errors: PICKUP_DATE_EXCEEDS_MAX_LIMIT](https://developers.test.transferz.com/reference/errors/pickup-date-exceeds-max-limit.md): Pickup date out of range - [Errors: QUOTE_EXPIRED](https://developers.test.transferz.com/reference/errors/quote-expired.md): The quote has expired - [Errors: QUOTE_CAPACITY_CONSTRAINT](https://developers.test.transferz.com/reference/errors/quote-capacity-constraint.md): Too many passengers or bags for the quote - [Errors: QUOTE_PERMISSION](https://developers.test.transferz.com/reference/errors/quote-permission.md): Quotes belong to different partners - [Errors: JOURNEY_TRAVEL_ADDON_MAX_ALLOWED_AMOUNT_EXCEEDED](https://developers.test.transferz.com/reference/errors/journey-travel-addon-max-allowed-amount-exceeded.md): Too many of an add-on - [Errors: CANCELLATION_NOT_ALLOWED_FOR_JOURNEY](https://developers.test.transferz.com/reference/errors/cancellation-not-allowed-for-journey.md): The journey cannot be cancelled this way - [Errors: PAYMENT_ON_INVOICE_NOT_ALLOWED](https://developers.test.transferz.com/reference/errors/payment-on-invoice-not-allowed.md): Paying on invoice is not enabled - [Errors: STRIPE_PAYMENT_FAILED](https://developers.test.transferz.com/reference/errors/stripe-payment-failed.md): Stripe Connect payment failed - [Errors: NO_CHANGES_SUPPLIED](https://developers.test.transferz.com/reference/errors/no-changes-supplied.md): The change request is empty - [Errors: INVALID_JOURNEY_STATUS](https://developers.test.transferz.com/reference/errors/invalid-journey-status.md): The journey cannot be changed in its current status - [Errors: QUOTE_GENERATION_FAILED](https://developers.test.transferz.com/reference/errors/quote-generation-failed.md): No price for the changed journey - [Errors: JOURNEY_CHANGE_NOT_ALLOWED_AFTER_MODIFICATION_WINDOW](https://developers.test.transferz.com/reference/errors/journey-change-not-allowed-after-modification-window.md): Too late to change the journey - [Errors: JOURNEY_CHANGE_NOT_ALLOWED_WHEN_MINIMUM_NOTICE_EXCEEDED](https://developers.test.transferz.com/reference/errors/journey-change-not-allowed-when-minimum-notice-exceeded.md): The new pickup time is too soon - [Errors: JOURNEY_ERROR](https://developers.test.transferz.com/reference/errors/journey-error.md): The action is not possible for this journey - [Errors: JOURNEY_CHANGE_ERROR](https://developers.test.transferz.com/reference/errors/journey-change-error.md): The journey change could not be made - [Errors: JOURNEY_CHANGE_WRONG](https://developers.test.transferz.com/reference/errors/journey-change-wrong.md): The journey change belongs to another journey ### Walk-through - [Partner walk-through, step 1: Connect](https://developers.test.transferz.com/walkthrough/partner/connect.md): Every call to the Partners API carries your API key in the X-API-Key header. There is no separate login call: the key alone identifies you. - [Partner walk-through, step 2: Get prices](https://developers.test.transferz.com/walkthrough/partner/get-prices.md): Before you can book, you ask Transferz what the trip costs. You send where the trip starts and ends, the local pickup time and how many people and bags travel. - [Partner walk-through, step 3: Book the trip](https://developers.test.transferz.com/walkthrough/partner/book-the-trip.md): A booking turns the chosen quote into a reservation. You add who booked it, who travels and any extras, such as meet and greet. - [Partner walk-through, step 4: Confirm the booking](https://developers.test.transferz.com/walkthrough/partner/confirm-the-booking.md): Paying confirms that the booking should go ahead. Partners with an invoice agreement pay by invoice: one call, no payment page. - [Partner walk-through, step 5: Follow the ride](https://developers.test.transferz.com/walkthrough/partner/follow-the-ride.md): On the day, Transferz tells your endpoint what happens: a driver is assigned, the vehicle is known, and the driver's position updates as they drive to Schiphol. - [Partner walk-through, step 6: Move the pickup time](https://developers.test.transferz.com/walkthrough/partner/move-the-pickup-time.md): Plans change before the ride: Alex's flight is delayed and a colleague joins. You ask for a change to the journey with the new pickup time and travellers. - [Partner walk-through, step 7: Cancel](https://developers.test.transferz.com/walkthrough/partner/cancel.md): If the trip is no longer needed, cancel the journey. Within the free cancellation window this costs nothing; after it, you must accept the charges. ## For transfer companies ### Guides - [Getting started as a transfer company](https://developers.test.transferz.com/guides/transfer-companies/getting-started.md): Make your first call to the Transferz staging API from your own system. You need the onboarding email from Transferz. About 10 minutes. - [How a journey reaches you](https://developers.test.transferz.com/guides/transfer-companies/how-a-journey-reaches-you.md): How journeys reach a transfer company, by direct assignment or through the offer flow. - [Receive journeys by webhook](https://developers.test.transferz.com/guides/transfer-companies/receive-journeys-by-webhook.md): Receive new, changed and unassigned journeys on your webhook endpoint. - [Accept or decline offers](https://developers.test.transferz.com/guides/transfer-companies/accept-or-decline-offers.md): Receive offers for journeys and accept or decline them with a reason. - [Look up and search journeys](https://developers.test.transferz.com/guides/transfer-companies/look-up-and-search-journeys.md): Get one journey by id or search your journeys with filters and pagination. - [Assign a driver and a vehicle](https://developers.test.transferz.com/guides/transfer-companies/assign-a-driver-and-vehicle.md): Assign, change or remove the driver and vehicle of a journey. - [Report journey progress](https://developers.test.transferz.com/guides/transfer-companies/report-journey-progress.md): Report driver underway, arrived and in progress, and send the driver's live position. - [Complete a journey](https://developers.test.transferz.com/guides/transfer-companies/complete-a-journey.md): Mark a journey as completed once the traveller has been dropped off. - [Report a no-show or a delay](https://developers.test.transferz.com/guides/transfer-companies/report-a-no-show-or-delay.md): Report a traveller no-show or a driver who left the pickup, with photo evidence. - [Update pickup information for shared journeys](https://developers.test.transferz.com/guides/transfer-companies/update-pickup-information.md): Update the pickup time and details of a shared journey. - [Meet and greet](https://developers.test.transferz.com/guides/transfer-companies/meet-and-greet.md): Report that the host met the traveller for journeys with meet and greet. - [Handle changes and cancellations](https://developers.test.transferz.com/guides/transfer-companies/handle-changes-and-cancellations.md): Handle journey changes and cancellations that Transferz sends you. ### API reference - [Transfer Companies API: Decline offer (POST /offers/{id}/decline)](https://developers.test.transferz.com/reference/transfer-companies/decline-offer.md): Declines an available offer - [Transfer Companies API: Accept offer (POST /offers/{id}/accept)](https://developers.test.transferz.com/reference/transfer-companies/accept-offer.md): Accepts an available offer - [Transfer Companies API: Get offer (GET /offers/{id})](https://developers.test.transferz.com/reference/transfer-companies/get-offer.md): Retrieves a specific offer by id - [Transfer Companies API: Get available offers (GET /offers/available/all)](https://developers.test.transferz.com/reference/transfer-companies/list-available-offers.md): Retrieves all available offers for the provided credentials - [Transfer Companies API: Unassign vehicle (PUT /journeys/{id}/unassign-vehicle)](https://developers.test.transferz.com/reference/transfer-companies/unassign-vehicle.md): Unassigns the currently selected vehicle from the journey driver - [Transfer Companies API: Unassign driver (PUT /journeys/{id}/unassign-driver)](https://developers.test.transferz.com/reference/transfer-companies/unassign-driver.md): Unassigns the currently selected driver from the journey - [Transfer Companies API: Update status to 'in progress' (PUT /journeys/{id}/status/in-progress)](https://developers.test.transferz.com/reference/transfer-companies/set-journey-in-progress.md): Indicates the journey is in progress and driver is en-route to the drop-off point - [Transfer Companies API: Update status to 'driver underway' (PUT /journeys/{id}/status/driver-underway)](https://developers.test.transferz.com/reference/transfer-companies/set-driver-underway.md): Indicates a driver is en-route to the pickup point - [Transfer Companies API: Update status to 'driver arrived' (PUT /journeys/{id}/status/driver-arrived)](https://developers.test.transferz.com/reference/transfer-companies/set-driver-arrived.md): Indicates a driver has arrived at the pickup point and is waiting for the traveller - [Transfer Companies API: Update pickup information (PUT /journeys/{id}/pickup-info)](https://developers.test.transferz.com/reference/transfer-companies/update-pickup-information.md): Updated pickup information for the given journey - [Transfer Companies API: Mark that the host met the traveller (PUT /journeys/{id}/host-traveller-met)](https://developers.test.transferz.com/reference/transfer-companies/mark-host-met-traveller.md): Records the moment the host found the traveller, optionally with the position where it happened - [Transfer Companies API: Update driver position (PUT /journeys/{id}/driver-position)](https://developers.test.transferz.com/reference/transfer-companies/update-driver-position.md): Sets the last known driver position - [Transfer Companies API: Complete journey (PUT /journeys/{id}/complete)](https://developers.test.transferz.com/reference/transfer-companies/complete-journey.md): Marks a journey as completed - [Transfer Companies API: Assign vehicle (PUT /journeys/{id}/assign-vehicle)](https://developers.test.transferz.com/reference/transfer-companies/assign-vehicle.md): Assigns a vehicle to a journey driver - [Transfer Companies API: Assign to driver (PUT /journeys/{id}/assign-driver)](https://developers.test.transferz.com/reference/transfer-companies/assign-driver.md): Assigns a journey to a driver and sends an optional SMS message - [Transfer Companies API: Search journeys (GET /journeys)](https://developers.test.transferz.com/reference/transfer-companies/search-journeys.md): Retrieves a list of journeys based on the provided parameters for which an offer has been accepted - [Transfer Companies API: Get journey (GET /journeys/{id})](https://developers.test.transferz.com/reference/transfer-companies/get-journey.md): Retrieves a specific journey by id - [Transfer Companies API: Search actions (GET /actions)](https://developers.test.transferz.com/reference/transfer-companies/search-actions.md): Retrieves the actions for the given search parameters - [Transfer Companies API: Create action (POST /actions)](https://developers.test.transferz.com/reference/transfer-companies/create-action.md): Creates action for specified journey - [Transfer Companies API: Upload attachment (POST /actions/{actionId}/photo)](https://developers.test.transferz.com/reference/transfer-companies/upload-action-attachment.md): Handles multipart file request data for the provided action id - [Transfer Companies API: Get operation zone (GET /operation-zones/{id})](https://developers.test.transferz.com/reference/transfer-companies/get-operation-zone.md): Retrieves an operation zone by its identifier - [Transfer Companies API: Get geo zone (GET /geo-zones/{id})](https://developers.test.transferz.com/reference/transfer-companies/get-geo-zone.md): Retrieves a geo zone by its identifier - [Webhook events: Journey assigned](https://developers.test.transferz.com/reference/webhooks/journey-assigned.md): A journey was assigned to one of your fleets. - [Webhook events: Journey details updated](https://developers.test.transferz.com/reference/webhooks/journey-details-updated.md): The pickup time, pickup location or drop-off location of an assigned journey changed. - [Webhook events: Journey unassigned](https://developers.test.transferz.com/reference/webhooks/journey-unassigned.md): A journey is no longer assigned to your company. - [Webhook events: Offer available](https://developers.test.transferz.com/reference/webhooks/offer-created.md): A new offer for a journey is available to your company. - [Webhook events: Offer status changed](https://developers.test.transferz.com/reference/webhooks/offer-status-changed.md): The status of an offer to your company changed, for example it expired or another company took it. - [Webhook events: Traveller details updated](https://developers.test.transferz.com/reference/webhooks/traveller-details-updated.md): Traveller information of an assigned journey changed, for example the phone number or passenger count. - [Errors: INVALID_REQUEST](https://developers.test.transferz.com/reference/errors/invalid-request.md): The request is not valid - [Errors: DRIVER_NOT_ASSIGNED](https://developers.test.transferz.com/reference/errors/driver-not-assigned.md): No driver assigned yet - [Errors: JOURNEY_ALREADY_ASSIGNED_TO_OTHER_DRIVER](https://developers.test.transferz.com/reference/errors/journey-already-assigned-to-other-driver.md): Another driver is assigned - [Errors: VEHICLE_ALREADY_ASSIGNED](https://developers.test.transferz.com/reference/errors/vehicle-already-assigned.md): A vehicle is already assigned - [Errors: JOURNEY_STATUS_CHANGE_NOT_ALLOWED_IF_PICKUP_TIME_TOO_FAR_IN_FUTURE](https://developers.test.transferz.com/reference/errors/journey-status-change-not-allowed-if-pickup-time-too-far-in-future.md): Too early for this status - [Errors: STATUS_TRANSITION_NOT_ALLOWED](https://developers.test.transferz.com/reference/errors/status-transition-not-allowed.md): Status change not allowed - [Errors: COMPLETE_JOURNEY_NOT_ALLOWED_BEFORE_PICKUP](https://developers.test.transferz.com/reference/errors/complete-journey-not-allowed-before-pickup.md): Cannot complete before pickup - [Errors: HOST_TRAVELLER_MET_NOT_ALLOWED_FOR_STATUS](https://developers.test.transferz.com/reference/errors/host-traveller-met-not-allowed-for-status.md): Cannot record the meeting in this status - [Errors: HOST_TRAVELLER_MET_ALREADY_RECORDED](https://developers.test.transferz.com/reference/errors/host-traveller-met-already-recorded.md): Meeting already recorded - [Errors: HOST_TRAVELLER_MET_TIME_IN_FUTURE](https://developers.test.transferz.com/reference/errors/host-traveller-met-time-in-future.md): Meeting time is in the future - [Errors: MAX_PAGE_SIZE_LIMIT_EXCEEDED](https://developers.test.transferz.com/reference/errors/max-page-size-limit-exceeded.md): Page size too large - [Errors: OFFER_MISSED](https://developers.test.transferz.com/reference/errors/offer-missed.md): Another company accepted the offer - [Errors: OFFER_EXPIRED](https://developers.test.transferz.com/reference/errors/offer-expired.md): The offer has expired - [Errors: OFFER_FINALIZED](https://developers.test.transferz.com/reference/errors/offer-finalized.md): The offer can no longer change - [Errors: INVALID_MEETING_POINT](https://developers.test.transferz.com/reference/errors/invalid-meeting-point.md): Meeting point missing or unknown - [Errors: INBOUND_JOURNEY_MEETING_POINT](https://developers.test.transferz.com/reference/errors/inbound-journey-meeting-point.md): Meeting point not allowed for this journey - [Errors: DECLINE_DESCRIPTION_MISSED](https://developers.test.transferz.com/reference/errors/decline-description-missed.md): Description needed for this reason - [Errors: UNSUPPORTED_CONTENT_TYPE](https://developers.test.transferz.com/reference/errors/unsupported-content-type.md): File type not supported ### Walk-through - [Transfer company walk-through, step 1: Connect](https://developers.test.transferz.com/walkthrough/transfer-company/connect.md): Transferz pushes journeys to you, so it needs an HTTPS endpoint to send them to. You set that URL in the workspace and get a signature key to check that events really come from Transferz. - [Transfer company walk-through, step 2: Receive a journey by webhook](https://developers.test.transferz.com/walkthrough/transfer-company/receive-a-journey.md): When a journey is given to your fleet, Transferz sends journeyFleetAssignedEvent to your endpoint, with the pickup, drop-off, time and traveller details. - [Transfer company walk-through, step 3: Assign a driver](https://developers.test.transferz.com/walkthrough/transfer-company/assign-a-driver.md): The traveller wants to know who picks them up. Assign the driver with a name and phone number as soon as you have planned the ride. - [Transfer company walk-through, step 4: Assign a vehicle](https://developers.test.transferz.com/walkthrough/transfer-company/assign-a-vehicle.md): Next, tell Transferz which car is coming. The licence plate helps the traveller find the right vehicle at the kerb. - [Transfer company walk-through, step 5: Share journey tracking](https://developers.test.transferz.com/walkthrough/transfer-company/share-journey-tracking.md): During the ride, the traveller and the partner follow the driver live. Either your driver uses the Transferz Driver App, which reports everything by itself, or your own system reports status and positions through the API. - [Transfer company walk-through, step 6: Complete the journey](https://developers.test.transferz.com/walkthrough/transfer-company/complete-the-journey.md): When the traveller is dropped off, complete the journey with the drop-off position and time. This closes the ride for the traveller, the partner and invoicing. - [Transfer company walk-through, step 7: The offer flow](https://developers.test.transferz.com/walkthrough/transfer-company/offer-flow.md): Some companies get journeys as offers instead of direct assignments. Transferz sends offerCreatedEvent; you accept it, with a meeting point, or decline it with a reason before it expires. ## Downloads - [Partners API OpenAPI file](https://developers.test.transferz.com/reference/downloads/partners.openapi.json) (Partners) - [Partners API Postman collection](https://developers.test.transferz.com/reference/downloads/partners.postman_collection.json) (Partners) - [Transfer Companies API OpenAPI file](https://developers.test.transferz.com/reference/downloads/transfer-companies.openapi.json) (Transfer companies) - [Transfer Companies API Postman collection](https://developers.test.transferz.com/reference/downloads/transfer-companies.postman_collection.json) (Transfer companies) - [Postman staging environment](https://developers.test.transferz.com/reference/downloads/staging.postman_environment.json) (Everyone)