Get started

Rate limits

429· Too Many Requests

Throughput is constrained by physical-world fulfillment. Every successful cart checkout enters a queue handled by the print-on-demand subsystem and a third-party carrier. Plan accordingly.

Tiers

Tier	Latency	Carrier
standard	~5–7 business days TTFB	USPS Ground
expedited	~2–3 business days TTFB	UPS / FedEx
overnight	subject to availability	contact support

// TTFB == time to first box

Response headers

x-headers

Retry-After: 3-7 business days
X-RateLimit-Carrier: USPS
X-RateLimit-Tier: ground
X-Idempotency-Window: 30d

Retry policy

We do not retry. The carrier may attempt redelivery up to 3 times before returning the package to origin. Exponential backoff is implemented at the USPS sorting facility level and is not configurable.

Idempotency

Returns are processed within a 30-day idempotency window. After the window closes, the request is considered committed.

Response 202· Accepted

{
  "object": "return",
  "status": "pending",
  "window_expires_in": "30d",
  "instructions": "Reply to your order confirmation email with the order id."
}