Skip to content

Mark that the host met the traveller

PUT/journeys/{id}/host-traveller-met

Auth: X-API-Key headerhttps://warpdrive.staging.transferz.com/transfercompanies

Records the moment the host found the traveller, optionally with the position where it happened

Records the moment the host or driver met the traveller (for example at the meet and greet sign), optionally with the position. Only possible while the journey is CONFIRMED, PLANNED, DRIVER_UNDERWAY or DRIVER_ARRIVED, and only once.

Guide: Meet and greet

Path parameters

  • idinteger · int64required

    The id of the journey to update

Headers

  • X-Request-IDstring

    The optional (ideally unique) request identifier used for later analysis or diagnostics

Request body

application/json

  • latitudenumber · double

    The latitude where the host met the traveller

    Example: 52.3105

  • longitudenumber · double

    The longitude where the host met the traveller

    Example: 4.7683

  • recordedAtstring · date-time

    The moment the event occurred, in UTC. Defaults to the time of the request when omitted.

    Example: 2026-02-20T06:10:04.639

Responses

No content

Errors this endpoint can return

  • When: The journey is already in progress, completed or cancelled.

    What to do: Record the meeting before the journey is in progress.

  • When: The meeting was already recorded.

    What to do: No action needed; the first record stands.

  • When: recordedAt is in the future.

    What to do: Send the time it happened, in UTC, or leave recordedAt out.

  • When: The journey is not assigned to your company (also returned for an unknown id).

    What to do: Check that the id belongs to your company and that you use the key of the right user. Ask Transferz to check the account's permissions if the id is correct.