API GETPRICE COURSIER.FR V7 (EN)
| 19/08/2026 |  |
Version 7.1 |
Objective
Retrieve available services, prices, delays, slots for an immediate or scheduled pickup for a given shipment, pick-up address and delivery address. Placing an order via the "Order API" does not require calling this "GetPrice API" beforehand, but we recommend doing so, especially to display available slots on a website.
Protocol
Requests are made via HTTPS using the url api.coursier.fr/v7/getprice.php. The response is a JSON containing the list of services/available slots which can be chosen to place the order.
Authentication
Authentication is done using an API key associated with your coursier.fr user account. Please contact our sales team at commercial@coursier.fr to obtain credentials. A monthly billing account is required.
The following parameters are required for authentication: Apikey, ClientId, User. Note that a single user may be linked to several customer accounts.
To test our APIs, you may use the following testing account to begin your developing tasks while waiting for your final credentials:
User : test@apicfr.fr
ClientId : 7055339
Apikey : e1ab1411d66765e73cf4b068d39cda8a
Parameters
Parameters must be send in a JSON array using the POST method.
|
NOM |
REQUIRED |
TYPE |
DESCRIPTIF |
|
User |
Y |
Varchar(180) |
User email to access coursier.fr interface |
|
Apikey |
Y |
Varchar(32) |
Apikey linked to your user |
|
ClientId |
Y |
int |
Customer account number |
|
StartDate |
N |
datetime |
Default value is now. For direct deliveries a delayed date can be specified to take into account for a cutoff time. For slot-based deliveries StartDate has to be expected delivery slot start date Format « YYYY-MM-DD HH:MM:SS ». |
|
FromAddress.Latitude |
Y/N |
Decimal(9,7) |
Optional if address fields (Address, PostalCode, City, Country) are specified. Required if address fields are null. |
|
FromAddress.Longitude |
Y/N |
Decimal(9,7) |
Optional if address fields (Address, PostalCode, City, Country) are specified. Required if address fields are null. |
|
FromAddress.Address |
Y/N |
Varchar(120) |
Number and street of pick-up address Can be null if Latitude/Longitude are specified |
|
FromAddress.PostalCode |
Y/N |
Varchar(10) |
Zipcode of pick-up address Can be null if Latitude/Longitude are specified |
|
FromAddress.City |
Y/N |
Varchar(50) |
Pick-up city Can be null if Latitude/Longitude are specified |
|
FromAddress.Country |
Y/N |
Varchar(50) |
Pick-up country in full (example : France) Can be null if Latitude/Longitude are specified |
|
ToAddress.Latitude |
Y/N |
Decimal(9,7) |
Optional if address fields (Address, PostalCode, City, Country) are specified. Required if address fields are null. |
|
ToAddress.Longitude |
Y/N |
Decimal(9,7) |
Optional if address fields (Address, PostalCode, City, Country) are specified. Required if address fields are null. |
|
ToAddress.Address |
Y/N |
Varchar(120) |
Number and street of shipping address Can be null if Latitude/Longitude are specified |
|
ToAddress.PostalCode |
Y/N |
Varchar(10) |
Zipcode of shipping address Can be null if Latitude/Longitude are specified |
|
ToAddress.City |
Y/N |
Varchar(50) |
Shipping city Can be null if Latitude/Longitude are specified |
|
ToAddress.Country |
Y/N |
Varchar(50) |
Shipping country in full (example : France) Can be null if Latitude/Longitude are specified |
|
Packages |
Y |
Array() |
Array containing the packages |
|
Lang |
N |
Varchar(2) |
Language code for the display of labels, default value is FR. |
Packages :
|
NAME |
REQUIRED |
TYPE |
DESCRIPTION |
|
Name |
Y |
Varchar(32) |
Free text : nature of the package (folds, parcel, bag, pallet...) For safety reasons, avoid mentioning the contents when it is of high value (jewelry, etc) |
|
NumberOfPackage |
Y |
Int |
Amount of similar packages |
|
Weight |
Y |
double |
Unit weight in kg |
|
Length |
Y |
Double |
Unit length in cm |
|
Width |
Y |
double |
Unit width in cm |
|
Height |
Y |
Double |
Unit height in cm |
If you lack the exact measurements of your packages, you may refer to the standard grid below.
| Name | Weight | Length | Width | Height | Example |
| XS | 1 | 30 | 20 | 5 | Fold |
| S | 3 | 30 | 25 | 25 | Small package |
| M | 5 | 40 | 30 | 30 | Medium package |
| L | 15 | 60 | 40 | 40 | Big package |
| XL | 100 | 80 | 60 | 100 | Half pallet |
| XXL | 250 | 80 | 120 | 100 | Pallet |
Wrong package measurements may lead to a supplement and a delivery delay.
JSON Response
The response is a JSON array containing the different available services, their price and the associated timelines. For slots, the response includes one line for each available slot, each line having a matching service_id. In case of error, the API returns a JSON with a Message field specifying the nature of the error.
|
NAME |
TYPE |
DESCRIPTION |
|
ServiceId |
int |
ID of the service, will be needed to place the order |
|
Service |
Varchar(100) |
Label of the service in the language chosen |
|
PickupStartDate |
Datetime |
Beginning of the pick-up slot |
|
PickupEndDate |
Datetime |
End of the pick-up slot |
|
DeliveryStartDate |
Datetime |
Beginning of the shipping slot |
|
DeliveryEndDate |
Datetime |
End of the shipping slot |
|
Price |
Float |
Pre-tax price of the delivery |
Example1 - Payload with latitude/longitude
{
"User": "corporate.service@deliveroo.fr",
"Apikey": "f933511046beb0224470d8cbecec82a2",
"ClientId": "8245027",
"StartDate": "2026-08-20 13:00:00",
"FromAddress": {
"Latitude": "48.8713882",
"Longitude": "2.3204516"
},
"ToAddress": {
"Latitude": "48.8763882",
"Longitude": "2.3294516"
},
"Packages": [
{
"Name": "Deliveroo Box",
"NumberOfPackage": 3,
"Weight": 10,
"Length": 56,
"Width": 37,
"Height": 21
}
],
"Lang":"FR"
}Example2 - Payload with full address
{
"User": "corporate.service@deliveroo.fr",
"Apikey": "f933511046beb0224470d8cbecec82a2",
"ClientId": "8245027",
"StartDate": "2026-08-20 13:00:00",
"FromAddress": {
"Address": "33 Rue Rodier",
"PostalCode": "75009",
"City": "Paris",
"Country": "France"
},
"ToAddress": {
"Address": "33 Rue La Fayette",
"PostalCode": "75009",
"City": "Paris",
"Country": "France"
},
"Packages": [
{
"Name": "Deliveroo Box",
"NumberOfPackage": 3,
"Weight": 10,
"Length": 56,
"Width": 37,
"Height": 21
}
]
}Response
[{"ServiceId":"97","Service":"Scheduled catering delivery","PickupStartDate":"2026-08-20 12:30:00",
"PickupEndDate":"2026-08-20 12:50:00","DeliveryStartDate":"2026-08-20 12:45:00","DeliveryEndDate":"2026-08-20 13:15:00","Price":"18.15"}]