Mark that the host met the traveller
/journeys/{id}/host-traveller-metAuth: 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
Headers
Request body
application/json
Responses
No content
Errors this endpoint can return
- 400, failedHOST_TRAVELLER_MET_NOT_ALLOWED_FOR_STATUS
When: The journey is already in progress, completed or cancelled.
What to do: Record the meeting before the journey is in progress.
- 400, failedHOST_TRAVELLER_MET_ALREADY_RECORDED
When: The meeting was already recorded.
What to do: No action needed; the first record stands.
- 400, failedHOST_TRAVELLER_MET_TIME_IN_FUTURE
When: recordedAt is in the future.
What to do: Send the time it happened, in UTC, or leave recordedAt out.
- 403, failedINSUFFICIENT_PERMISSIONS
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.