Skip to content

Update status to 'driver arrived'

PUT/journeys/{id}/status/driver-arrived

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

Indicates a driver has arrived at the pickup point and is waiting for the traveller

Reports that the driver is at the pickup point and waiting; the journey moves to DRIVER_ARRIVED.

Guide: Report journey progress

Path parameters

  • idinteger · int64required

    The id of the journey (journeyId in webhook events).

Headers

  • X-Request-IDstring

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

Request body

application/json

  • latitudenumber · doublerequired

    Latitude in decimal degrees.

  • longitudenumber · doublerequired

    Longitude in decimal degrees.

  • 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 completed or cancelled.

    What to do: Do not send further status updates for completed or cancelled journeys.

  • 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.