# API GETPRICE COURSIER.FR V7 (EN)
19/08/2026[![image-1662457811981.png](https://bookstack.digf.fr/uploads/images/gallery/2022-09/scaled-1680-/image-1662457811981.png)](https://bookstack.digf.fr/uploads/images/gallery/2022-09/image-1662457811981.png)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 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 : 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.

NameWeightLengthWidthHeightExample
XS130205Fold
S3302525Small package
M5403030Medium package
L15604040 Big package
XL1008060100Half pallet
XXL25080120100Pallet

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** ```JSON {

    "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** ```JSON {

"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** ```JSON [{"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"}] ``` #####