Gire Public API
Customers of Gire can order Pickup and Delivery of cars (PUDs) using this API. The documentation should help you set up the integration. If you have any questions, reach out to [email protected]
For using our API you need to be a customer of Gire
You can get your API token from your customer profile logged in as the main contact/administrator:
Place the api token in header as:
"x-api-token": <company api token>
We can also set up a dev environment for you for developing and testing. Please contact [email protected]
post
https://giremobility.com/api/v2
/puds
Create a new PUD
{
"pickup_address": "Pilestredet Park 12A, Oslo",
"delivery_address": "Karl Johans gate 12, Oslo",
"pickup_postal_code": "0101",
"delivery_postal_code": "1007",
"car_model": "Ferrari",
"reg_number": "MB1234K",
"customer_name": "John Doe",
"customer_phone": "420000001",
"pickup_name": "Tor Fergunsen",
"pickup_phone": "420000002",
"delivery_name": "John Wick",
"delivery_phone": "420000003",
"pickup_datetime_from": "2023-10-25T13:00:00.000Z",
"pickup_datetime_to":"´"2023-10-25T15:00:00.000Z"
"delivery_datetime": "2023-10-25T18:00:00.000Z",
"reference_number": "ref-number-123"
}
Some restrictions you should follow to make sure that your PUD will be placed:
pickup_datetime_from must be forward from now (in the feature)
pickup_datetime_to must be at least 4 hours forward from now
pickup_datetime_to must be at least 1 hour forward from pickup_datetime_from
delivery_datetime must be equal or forward from pickup_datetime_to
delivery_datetime should be at least 1 hour forward from pickup_datetime_from
With Gire you can get you car transported the same day as you place the order every day of the week
- You can book PUDs with pickup and delivery times within our opening hours 06:00-22:00 every day
- On same day booking, the delivery datetime has to be at least 4 hours forward from current datetime
- We need 1 hour timeslot for pickup time. Eg. you can book a PUD with Pickup time 08:00-09:00 and delivery time 09:00
Usually the price is calculated automatically during PUD creation
But if we can't find the adresses, or we cant automatically find a public transport route to the location, we will set the price = null. Please contact us with more information regarding the PUD and we will manually set a price.
- Gire Norway - [email protected]
- Gire Sweden - [email protected]
- Gire Denmark - [email protected]
Gires standard delivery areas are based around the cities listed below. This is where we have our driver bases and predefined prices based on zip codes. In the standard delivery areas we have a 4 hour delivery guarantee for same day bookings, and 1 hour guarantee for next day booking.
Standard Delivery Areas:
- Oslo
- Bergen
- Trondheim
- Stavanger
- Kristiansand
- Stockholm
- Copenhagen
We do also pickup and deliver cars outside of these area, but the prices are calculated by an algorithm that is based on travel time for the drivers. Also, we need 0-3 days to deliver on PUDs outside of our standard delivery area.
get
https://giremobility.com/api/v2
/puds/{:id}
Get PUD by ID
put
https://giremobility.com/api/v2
/puds
Edit PUD
get
https://giremobility.com/api/v2
/puds
Get list of PUDs
get
https://giremobility.com/api/v2
/puds_qty
Get count of PUDs for selected filters, returns number
delete
https://giremobility.com/api/v2
/puds/{:id}
PUD Cancellation
get
https://giremobility.com/api/v2
/price_estimation
Price Estimation
Note: Please don't forget to use url encoding when you send any text as query params (like search, address etc)
We can also set up a dev environment for you for developing and testing. Please contact [email protected]
Last modified 30d ago