PUDs
A PUD (pickup-and-delivery) is what we call a booking at Gire Mobility.
Create a PUD


Company API key
Specify ID of company to place booking
90sdfjs09fdsComment
This is a commentHyre booking id
123456Reference number
123456Pud created
VALIDATION_ERROR
UNAUTHORIZED
BOOKING_BAN
BOOKING_BLOCKED
Unprocessable entity, multiple error types possible. See examples.
Company API key
Specify ID of company to place booking
90sdfjs09fdsComment
This is a commentHyre booking id
123456Reference number
123456Immediate return Pud created
VALIDATION_ERROR
UNAUTHORIZED
BOOKING_BAN
BOOKING_BLOCKED
Unprocessable entity, multiple error types possible. See examples.
Cancel a PUD
Company API key
Pud successfully cancelled
id
Status of the trip
completedPossible values: Comment
Please check the fuel levelPickup code
eb9fCreated at
Updated at
Admin comment
The company which the pud belongs to
Missed trip reason
Car did not startHyre booking id
Reference number
UNAUTHORIZED
NOT_FOUND
CANNOT_CANCEL_PUD
Update a PUD
Company API key
Comment
Please handle with careReference number
REF123456Hyre booking id
123456Pud updated
id
Status of the trip
completedPossible values: Comment
Please check the fuel levelPickup code
eb9fCreated at
Updated at
Admin comment
The company which the pud belongs to
Missed trip reason
Car did not startHyre booking id
Reference number
VALIDATION_ERROR
UNAUTHORIZED
NOT_FOUND
Get PUD
Company API key
Pud found
id
Status of the trip
completedPossible values: Comment
Please check the fuel levelPickup code
eb9fCreated at
Updated at
Admin comment
The company which the pud belongs to
Missed trip reason
Car did not startHyre booking id
Reference number
UNAUTHORIZED
NOT_FOUND
The page number to return
1Example: 1The number of items to return per page
10Example: 10The date to filter by pickup date from
2025-01-01T00:00:00.000ZThe date to filter by pickup date to
2025-12-01T00:00:00.000ZThe search query to filter by
123456The status to filter by
completedThe field to sort by
createdAtExample: createdAtThe direction to sort by
descExample: descCompany API key
Pud list
VALIDATION_ERROR
UNAUTHORIZED
Company API key
Puds found
id
Status of the trip
completedPossible values: Comment
Please check the fuel levelPickup code
eb9fCreated at
Updated at
Admin comment
The company which the pud belongs to
Missed trip reason
Car did not startHyre booking id
Reference number
UNAUTHORIZED
Last updated