---
title: "Calculate shipping rates"
description: "Calculates shipping rates for a list of items."
canonical: "https://docs.printags.com/calculate-shipping-rates/"
last_updated: "2026-11-16"
---

# Calculate shipping rates

`POST /v2/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. To the United Kingdom (GB), the Sendcloud services (Colissimo International…) are not returned: the carrier refuses their label without the sender's UK VAT and EORI numbers, and order creation refuses them (GB_CUSTOMS_NUMBERS_REQUIRED). Use lpf_international to GB. The route stays public; an optional Bearer API key names the account.

## Authentication

None: this route answers without an API key.

## Request body

Content type: `application/json`, required.

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `to_country` | string | yes | ISO 2-letter destination country code. |
| `to_postal_code` | string | no | Destination postal code (reserved for postal-code-aware pricing). |
| `items` | array of object | yes | Items to ship. Weight and volume are derived from each model (and optional packaging). |
| `items[].productId` | string: `pvccard_white`, `mifare1k_pvccard_white`, `ntag213_pvccard_white`, `ntag216_pvccard_white`, `ntag424_pvccard_white`, `ntag424_woodcard` | yes | Product ID of the item. |
| `items[].packagingId` | string, nullable | no | Optional packaging ID, added to the item weight and volume. |
| `items[].quantity` | integer | no | Number of units for this item. |

```json
{
  "to_country": "FR",
  "to_postal_code": "75001",
  "items": [
    {
      "productId": "ntag424_pvccard_white",
      "packagingId": "aluminum_protection",
      "quantity": 10
    }
  ]
}
```

## Responses

| Status | Description |
| --- | --- |
| 200 | Successfully calculated shipping rates |
| 400 | Bad request, missing to_country or items |
| 404 | No matching models found for the provided items |
| 429 |  |
| 500 | Server error |

### 200 response

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `success` | boolean | no |  |
| `weight` | integer | no | Total shipping weight in grams (items + envelope). |
| `volume` | number | no | Total items volume in cm³. |
| `envelope` | [ShippingEnvelope](/schemas/shippingenvelope/) | no |  |
| `count` | integer | no |  |
| `carriers` | array of [ShippingRate](/schemas/shippingrate/) | no |  |

```json
{
  "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",
      "serviceCode": "chrono_18",
      "hasServicePoints": false,
      "price": 3,
      "weightTier": 250
    }
  ]
}
```

## Example

```bash
curl -X POST "https://api.printags.com/v2/shipping/rates" \
  -H "Content-Type: application/json" \
  -d '{"to_country":"FR","to_postal_code":"75001","items":[{"productId":"ntag424_pvccard_white","packagingId":"aluminum_protection","quantity":10}]}'
```
