---
title: "Validate a draft order"
description: "Validates a draft order: computes its prices and, with a live key, debits the account and sends it to production."
canonical: "https://docs.printags.com/validate-a-draft-order/"
last_updated: "2026-11-16"
---

# Validate a draft order

`POST /v2/accounts/{accountId}/orders/{orderId}/validate`

Validates a draft order: computes its prices and, with a live key, debits the account and sends it to production. The order must be in `draft` status. Test orders debit nothing.

## 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 |
| `orderId` | path | string | yes | Unique identifier of the order |

## Responses

| Status | Description |
| --- | --- |
| 200 | Order validated successfully |
| 400 | Bad request, invalid input |
| 401 | Unauthorized, authentication required, or an OAuth access token unknown, expired or revoked (`INVALID_TOKEN`) |
| 403 | The API key is inactive or revoked (`INACTIVE_API_KEY`), or targets another account (`ACCOUNT_ACCESS_DENIED`, refused once the account guard is enforced); 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`) |
| 404 | Order not found |
| 429 |  |
| 500 | Internal server error |

### 200 response

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `success` | boolean | no |  |
| `prices` | object | no |  |
| `prices.items` | array of object | no |  |
| `prices.items[].index` | integer | no |  |
| `prices.items[].quantity` | integer | no |  |
| `prices.items[].productId` | string | no |  |
| `prices.items[].unit_charges` | object | no |  |
| `prices.items[].charges` | object | no |  |
| `prices.items[].price` | number | no |  |
| `prices.items[].unit_price` | number | no |  |
| `prices.shipping` | object | no |  |
| `prices.shipping.transporter` | string | no |  |
| `prices.shipping.price` | number | no |  |
| `prices.total` | number | no |  |

```json
{
  "success": true,
  "prices": {
    "items": [
      {
        "index": 0,
        "quantity": 10,
        "productId": "ntag424_pvccard_white",
        "unit_charges": {
          "encoding": 0.5,
          "product": 0.5,
          "printing": 0.1,
          "packaging": 0.2,
          "recordOptions": 0.3
        },
        "charges": {
          "encoding": 5,
          "product": 5,
          "printing": 1,
          "packaging": 2,
          "recordOptions": 3
        },
        "price": 4.49,
        "unit_price": 4.49
      }
    ],
    "shipping": {
      "transporter": "default",
      "price": 5.99
    },
    "total": 50.99
  }
}
```

## Example

```bash
curl -X POST "https://api.printags.com/v2/accounts/123e4567-e89b-12d3-a456-426614174000/orders/987e6543-e21a-11d4-a789-0242ac120002/validate" \
  -H "Authorization: Bearer $PRINTAGS_API_KEY"
```
