Skip to content
TCGPlaytestdocsDashboard
Documentation API reference
API reference

Retrieve an order

Track a funded manufacturing order from payment to shipment.

GET /v1/orders/{id}

GET/v1/orders/{id}

Use cart.order_id or the data.id from an order.* webhook, not a cart ID or Stripe session ID. Live manufacturing orders exist after payment is recorded. Hosted/Connect simulator orders use test_order_… IDs; these and prepaid sandbox orders return mode: "test" and simulated: true and never print or ship.

Order status response
{
  "id": "00000000-0000-4000-a000-000000000042",
  "cart_id": "cart_aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
  "status": "shipped",
  "shipment": {
    "carrier": "Example carrier",
    "tracking_number": "TRACK-1042",
    "tracking_url": "https://shipping.example/track/TRACK-1042"
  },
  "created_at": "2026-10-06T12:10:00.000Z",
  "updated_at": "2026-10-08T15:00:00.000Z",
  "external_ref": "store-order-1042",
  "card_count": 3
}
Field / limitDescription
id / cart_idOpaque order ID and originating cart ID.
statuspaid, in_production, shipped, cancelled or blocked. blocked indicates a manufacturing hold.
shipmentNull when no shipment is attached; otherwise {carrier, tracking_number, tracking_url}. Carrier: up to 80 characters; tracking number: up to 150; tracking_url is HTTPS.
created_at / updated_atRFC 3339 timestamp strings with timezone; when the manufacturing order was created and last updated.
external_ref / card_countYour reference string or null, and integer sum of card quantities.

Signed events are the preferred update mechanism. If you reconcile through order GETs, they count toward the normal rate limit. A browser return to your site is not evidence of payment.

24 topics

Get startedOverview

Everything you need to turn artwork into printed cards.

Get startedFirst order in 10 minutes

A runnable sandbox example from test key to verified webhook delivery.

Get startedOrder with AI · MCP

Connect ChatGPT, Claude, Gemini or your developer tools, preview your cards and check out without a TCGPlaytest account or customer API key.

Get startedTest checkout & events

Simulate checkout, verify the order, return to your store and trigger signed test events.

Get startedQuickstart & authentication

Set up your account, protect your API key and make your first integration.

Get startedHow checkout works

Create a cart, wait for artwork validation and open checkout on your website.

Get startedCode examples

Working server examples in your preferred language.

Build your integrationCheckout widget

Connect finished images to a ready-made review and checkout experience.

Build your integrationEmbedded checkout

Keep delivery details and artwork confirmation inside your own website.

Build your integrationCheckout branding

Make checkout feel like your store with saved branding and style presets.

Build your integrationCustom success page

Return customers to your registered website after verified payment.

Build your integrationStripe Connect payouts

Set your card selling price and receive earnings, with a 5% reserve for 15 days.

Build your integrationPrinting credits

Use your balance for printing, with customer shipping and tax paid through Stripe.

API referenceUpload artwork

Request a temporary upload URL. Send file bytes directly to private storage.

API referenceCreate a cart

Submit finished artwork, quantities and your success URL for validation.

API referenceRetrieve a cart

Read validation progress, quality warnings and checkout availability.

API referenceRetrieve an order

Track a funded manufacturing order from payment to shipment.

API referenceWebhooks

Receive signed order updates on your server.

ResourcesArtwork & API limits

File specifications, card limits and request allowances for this deployment.

ResourcesErrors & retries

Understand failures and retry safely without creating duplicate carts.

ResourcesGoing live

Partner launch checklist: verified orders, allowed origins and live checkout.

ResourcesAffiliate codes

Apply your approved affiliate preference to new carts.

ResourcesExpiry & retention

Understand cart lifetimes, artwork storage and cleanup.

ResourcesTerms & image rights

Know your responsibilities and the customer acceptance requirements.