Skip to content

Complete journey

PUT/journeys/{id}/complete

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

Marks a journey as completed

Marks the journey as completed after the traveller has been dropped off. Send the drop-off position. Completed journeys count towards your payout.

Guide: Complete a journey

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 pickup time is still in the future.

    What to do: Complete the journey after it has taken place.

  • When: The journey was 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.