---
title: "Simulate a status change on a test order"
description: "Test environment only."
canonical: "https://docs.printags.com/simulate-a-status-change-on-a-test-order/"
last_updated: "2026-11-16"
---

# Simulate a status change on a test order

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

Test environment only. Moves a test order, created with a `sk_test_` key, to the requested status and sends the same webhooks as in production (`order.updated`, plus `order.shipped` or `order.delivered`). Without a printer, this is how you see an order go through its life cycle. Real orders are refused with a 404. A test order is processed within a few seconds of its creation: until then (statuses `creating`, `draft`, `in_queue`) this endpoint answers 409 `TEST_ORDER_NOT_READY`, retry shortly.

## 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. You can also use the alias `@me`. |
| `orderId` | path | string | yes | Unique identifier of the test order |

## Request body

Content type: `application/json`, required.

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `status` | string | yes | Any status of the order life cycle, see `GET /orders/statuses`. |

```json
{
  "status": "shipped"
}
```

## Responses

| Status | Description |
| --- | --- |
| 200 | Status changed, webhooks sent |
| 400 | Missing or unknown status |
| 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 | Test order not found. Only orders created with a `sk_test_` key can be simulated. |
| 409 | The test order is still being processed (`TEST_ORDER_NOT_READY`), retry in a few seconds |
| 429 |  |
| 500 | Internal server error |

### 200 response

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `success` | boolean | no |  |
| `order` | object | no | The order in its new status |

```json
{
  "success": true
}
```

## Example

```bash
curl -X POST "https://api.printags.com/v2/accounts/@me/orders/987e6543-e21a-11d4-a789-0242ac120002/simulate" \
  -H "Authorization: Bearer $PRINTAGS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"status":"shipped"}'
```
