Calculate shipping rates

POST

/shipping/rates

Calculates shipping rates for a list of items. The endpoint computes the total weight and volume of the items (model and optional packaging), selects the appropriate envelope, and returns the carrier services available for the destination with their price. Only services whose price is greater than 0 are returned.

Request

Authorization

JWT Bearer

Add the parameter

Authorization

to Headers

Example:

Authorization: ********************

Body Params application/jsonRequired

Examples

Responses

🟢200

application/json

Successfully calculated shipping rates

Bodyapplication/json

🟠400

🟠401

🟠404

🔴500

Request Example

Shell

JavaScript

Java

Swift

curl --location '/shipping/rates' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
    "to_country": "FR",
    "to_postal_code": "75001",
    "items": [
        {
            "modelId": "pvccard_white",
            "packagingId": "aluminum_protection",
            "quantity": 1
        }
    ]
}'

Response Example

{
    "success": true,
    "weight": 110,
    "volume": 42.5,
    "envelope": {
        "id": "custom",
        "name": "Emballage spécial",
        "weight": 50
    },
    "count": 2,
    "carriers": [
        {
            "id": "lpf_standard",
            "name": "La Poste - Lettre Suivie",
            "code": "laposte",
            "hasServicePoints": false,
            "price": 3,
            "weightTier": 250
        }
    ]
}

Modified at 2026-06-17 14:17:50

List available carriers

List available models