---
title: "Quote an order"
description: "Prices an order without creating it: the amount `createOrder` would debit for the same body, with the account's balance and whether it is enough."
canonical: "https://docs.printags.com/quote-an-order/"
last_updated: "2026-11-16"
---

# Quote an order

`POST /v2/accounts/{accountId}/orders/quote`

Prices an order without creating it: the amount `createOrder` would debit for the same body, with the account's balance and whether it is enough. Send the body you would send to `createOrder`: the country is read from `countryCode`, else `shipTo.address.countryCode`, else `shipTo.servicePoint.country`; the rest of `shipTo`, `reference` and `metadata` are not read, and only the presence of `printingVisuals` counts. Nothing is created or debited.

## Authentication

An API key as a Bearer token: `Authorization: Bearer <key>`. A `sk_test_` key creates and sees test orders only. Keys and test mode: [overview](/).

## Parameters

| Name | In | Type | Required | Description |
| --- | --- | --- | --- | --- |
| `accountId` | path | string | yes | Unique identifier of the account, or the alias `@me` for the account authenticated by the token. An API key or an OAuth token acts on its own account only: another account's id is refused with 403 `ACCOUNT_ACCESS_DENIED`. |

## Request body

Content type: `application/json`, required.

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `countryCode` | string | no | Delivery country (ISO 3166-1 alpha-2), instead of `shipTo` |
| `shipTo` | object | no | As in `createOrder`: only its country is read |
| `carrierServiceId` | string | no | ID of the carrier service to use for shipping. Defaults to 'lpf_standard' if not provided. Use a service that supports service points when shipTo contains a servicePoint. |
| `items` | array of object | yes |  |
| `items[].quantity` | integer | yes | Quantity of the product |
| `items[].productId` | string: `pvccard_white`, `mifare1k_pvccard_white`, `ntag213_pvccard_white`, `ntag216_pvccard_white`, `ntag424_pvccard_white`, `ntag424_woodcard` | yes | Product ID of the product |
| `items[].metadata` | object | no | Additional metadata for the product |
| `items[].packagingId` | string | no | ID of the packaging |
| `items[].printingVisuals` | array of string (uuid), nullable | no | List of printing visuals for the product, obtained from the files API |
| `items[].nfc` | [NFC](/schemas/nfc/) or array of [NFC](/schemas/nfc/) | no |  |

```json
{
  "countryCode": "FR",
  "carrierServiceId": "lpf_standard",
  "items": [
    {
      "quantity": 10,
      "productId": "ntag424_pvccard_white",
      "metadata": {
        "internalId": "a3d3842e-89c0-41d2-9384-2e89c021d2bc"
      },
      "packagingId": "aluminum_protection",
      "printingVisuals": [
        "0806a77d-8007-4cfc-86a7-7d80079cfc8f",
        "a77d8007-007c-fc86-7a7d-80079cfc8f0"
      ]
    }
  ]
}
```

## Responses

| Status | Description |
| --- | --- |
| 200 | The quote |
| 400 | No country (`MISSING_COUNTRY_CODE`), an invalid line (`INVALID_PARAMETERS`, `INVALID_QUANTITY`), an unknown product (`UNKNOWN_PRODUCT`), or a carrier service that does not serve the parcel or the country (`CARRIER_SERVICE_NOT_AVAILABLE`) |
| 401 | Unauthorized, authentication required, or an OAuth access token unknown, expired or revoked (`INVALID_TOKEN`) |
| 402 | The account has no plan, so no price (`SUBSCRIPTION_REQUIRED`) |
| 403 | The API key is inactive or revoked (`INACTIVE_API_KEY`), or the path names another account (`ACCOUNT_ACCESS_DENIED`); with an OAuth access token: a token of scope `mcp` (`INSUFFICIENT_SCOPE`), a path naming another account or a person no longer a member of it (`ACCOUNT_ACCESS_DENIED`), a real token on the sandbox host (`SANDBOX_REQUIRES_TEST_KEY`) |
| 500 | Internal server error |

### 200 response

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `success` | boolean | no |  |
| `quote` | [Quote](/schemas/quote/) | no |  |

```json
{
  "success": true,
  "quote": {
    "currency": "eur",
    "mode": "production",
    "totalExclVat": 42.5,
    "shippingExclVat": 2.5,
    "lines": [
      {
        "modelId": "ntag213_pvccard_white",
        "quantity": 50,
        "unitPriceExclVat": 0.8,
        "lineTotalExclVat": 40,
        "unitCharges": {
          "model": 0.5,
          "printing": 0.3
        }
      }
    ],
    "balance": 30,
    "enoughFunds": true
  }
}
```

## Example

```bash
curl -X POST "https://api.printags.com/v2/accounts/@me/orders/quote" \
  -H "Authorization: Bearer $PRINTAGS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"countryCode":"FR","carrierServiceId":"lpf_standard","items":[{"quantity":10,"productId":"ntag424_pvccard_white","metadata":{"internalId":"a3d3842e-89c0-41d2-9384-2e89c021d2bc"},"packagingId":"aluminum_protection","printingVisuals":["0806a77d-8007-4cfc-86a7-7d80079cfc8f","a77d8007-007c-fc86-7a7d-80079cfc8f0"]}]}'
```
