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"}]