AG provides a public REST API for programmatic ordering — useful if you're building a storefront, automation, or integration that needs to place AG orders without using the web checkout. API access is gated per account.
Enabling API access
API access is enabled by AG admins on a per-account basis. Once enabled, you'll see the API Keys card in Settings.
Generating an API key
- Open Settings and find the API Keys card.
- Click New key, give it a Name, and click Create.
- Copy the
ag_live_...token immediately — it's shown only once. - Store it securely (a secrets manager or
.envfile).
What you can do with the API
- Quote prices and delivery options before placing an order.
- Place orders with full configuration (paper, size, framing, mounting, delivery address).
- Manage your saved card — required for placing orders.
- List and retrieve orders placed via the API.
Authentication
Pass the token as a Bearer header on every request:
Authorization: Bearer ag_live_...
Required setup
- A saved card on file (see How to manage saved cards) — API orders charge automatically.
- A country of residence set on the account — drives currency and Stripe branch routing.
Idempotency
POST /v1/orders accepts an Idempotency-Key header to deduplicate retries safely. Always send one for production integrations.
Promo codes via the API
POST /v1/orders accepts a promo_code. Codes are validated — an invalid code rejects the order rather than silently charging full price — and an order fully covered by a promo needs no saved card. Large batch orders (around 150 items) are supported.