EasyExpress API v3 Documentation (Shipments)

Authentication

All requests must include the following header:

Authorization: Bearer YOUR_TOKEN

1. Get Shipping Rates

Method: POST
URL: /api/v3/shipments/rates

Description: Get available shipping options and rates.

Request Body Example:
{
  "parcels": [{ "weight": 2 }],
  "senderAddress": { "countryCode": "FR", "postalCode": "75013" },
  "receiverAddress": { "countryCode": "CH", "postalCode": "1206" }
}
Success Response:
{
  "Date": 1752788666,
  "Status": "SUCCEEDED",
  "Code": 200,
  "Message": {
    "transactionId": "...",
    "shipmentRequest": { ... },
    "carriers": [
      { "code": "colissimo_inter", "name": "Colissimo internationale", "price": 2193 },
      { "code": "ups", "name": "UPS", "price": 8040 }
    ]
  }
}

2. Create and Checkout Shipment (Standard)

Method: POST
URL: /api/v3/shipments/checkout

Description: Create and pay for a shipment within France or the EU.

Success Response:
{
  "Date": 1752789117,
  "Status": "SUCCEEDED",
  "Code": 200,
  "Message": {
    "transactionId": "...",
    "labels": "https://.../label.pdf",
    "parcels": [
      {
        "ticket": "https://.../ticket.pdf",
        "tracking": "XX044408915MP"
      }
    ]
  }
}

Error Response Example

{
    "Response": {
        "Date": 1763567996,
        "Status": "FAILED",
        "Code": 400,
        "Message": "The checkout request contains invalid parameter(s)."
    }
}

Country Code Examples

Note on PDF Invoices