Skip to main content
POST
Cancel an unpaid order

Path Parameters

id
string
required

Response

Cancelled order

id
string
Example:

"ord_8k2m4qz7c1x9b3vd"

object
enum<string>
Available options:
postcard,
letter
product
enum<string>
Available options:
postcard_4x6,
postcard_6x9,
postcard_6x11,
letter,
letter_certified,
letter_certified_rr
status
enum<string>
Available options:
awaiting_payment,
paid,
printing,
mailed,
cancelled,
refunded
status_detail
string
price
object
to
object

A US address (recipients are always in the US, including territories and APO/FPO/DPO).

from
object

Return address. It may be outside the US: set country. For a US address (no country, or US), state and zip are required and follow the US rules; elsewhere state is the region and zip the postcode, both optional.

content
object
checkout_url
string | null

Where the person pays. Null once paid or closed. Never expires.

order_url
string

Human-readable status page

preview_url
string

Exact print preview

created_at
string<date-time>
paid_at
string<date-time> | null
mailed_at
string<date-time> | null
events
object[]
certified
enum<string>

Letters only: the USPS extra service.

Available options:
none,
certified,
certified_return_receipt
tracking
object | null

USPS tracking once the piece is accepted (certified letters always get one).

batch_id
string | null

Set when the order is part of a batch (created with recipients). Its checkout_url is then the batch's single payment link.