Spider Trans Logistics International API 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

{
  "status": "error",
  "message": "Invalid carrierId"
}

Country Code Examples

Note on PDF Invoices