Shipping

List carriers for a destination

GET/v2/shipping/carriersTry it

Returns the carrier services available for a destination, each with its computed price. Useful to let a customer pick a carrierServiceId before creating an order. Only services whose price is greater than 0 for the requested destination are returned.

Request

Authorization

None: this route answers without an API key.

Query parameters
  • to_countrystringrequired
    ISO 2-letter destination country code.
  • to_postal_codestring
    Destination postal code (reserved for postal-code-aware pricing).
  • weightinteger
    Total weight in grams. When provided, only services whose weight range covers it are returned.

Responses

200Successfully retrieved available carriers
400Bad request, missing required parameter (e.g. to_country)

Type: Error

429
500Server error

Type: Error

Request
curl -X GET "https://api.printags.com/v2/shipping/carriers?to_country=FR"
Response 200
{
  "success": true,
  "count": 2,
  "carriers": [
    {
      "id": "lpf_standard",
      "name": "La Poste - Lettre Suivie",
      "code": "laposte",
      "hasServicePoints": false,
      "apiProvider": "laposte",
      "countries": [
        "FR",
        "BE"
      ],
      "enabledCountries": [
        "FR",
        "BE",
        "LU"
      ],
      "price": 2.3,
      "weightTier": 0,
      "priceTiers": {
        "0": 2.3,
        "250": 3
      },
      "minWeight": 0,
      "maxWeight": 3000
    }
  ]
}