Products
List available products
Returns the list of product models available, read from the database. This is the authoritative source for the productId values used when creating an order or calculating shipping rates. With include=prices, each model also carries price: what one printed card of it costs the authenticated account under its plan, excluding VAT and shipping (null when the plan does not price that model, or the account has no plan usable by this caller). It is priced as this caller's orders are, so a shop integration can use it as the product's cost; an order of several cards can fall into a cheaper tier of the plan, and its exact amount is given by the order quote.
Request
Authorization
Bearer token
Send your API key in the Authorization header: Authorization: Bearer sk_test_…. A sk_test_ key creates and sees test orders only. Keys and test mode.
Query parameters
includestring:pricespricesadds the account's price of one printed card to each model.
Responses
200Successfully retrieved available models
successbooleanmodelsarray of Product
401Unauthorized, authentication required, or an OAuth access token unknown, expired or revoked (INVALID_TOKEN)
Type: Error
403The 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)
Type: Error
429
500Server error
Type: Error