Tanqory API reference
Every call your app can make
1,627 operations across the Admin, Store and AI APIs, in 181 groups, generated from the OpenAPI documents the services publish. One Bearer token opens all three.
- Admin API292 operations
api.tanqory.comStoresBillingSubscriptionsCustom DomainsList all stores for authenticated user - Store API1,335 operations
api.tanqory.comOrdersProductsInventoryCustomers
Core concepts
What holds for every call
The three APIs share one token, one error shape and one way to retry, so code you write for one works for the others.
- AuthenticationOne JSON Web Token from the Admin API identity service is accepted by the Admin, Store and AI APIs. Send it as a Bearer header.
- Base URLsThe Admin and Store APIs share one host, api.tanqory.com, which routes a store's calls to the store's region; AI is the MCP server on the same host, at /v1/mcp.
- ErrorsEvery error is one error object with a stable code to switch on, the status, the field at fault and a request ID for support.
- Rate limitsOn 429 or 503, wait for Retry-After when it is sent, otherwise back off with jitter and try again.
- VersioningThe Admin and Store APIs carry their version in the path, /api/v1, and keep serving it unchanged when a new version arrives.
- PaginationList endpoints declare their own limit and offset or page parameters in the reference; read them on each operation.
{ "error": { "type": "validation_error", "code": "validation_failed", "title": "Please check your input", "message": "Some fields need attention before you can continue.", "status": 400, "param": "email", "errors": [ { "field": "email", "code": "invalid_type", "message": "Required" } ], "request_id": "e7cab0b72a2507b9953f4d1d3afb092f", "instance": "/api/v1/auth/register" }}Store data
Read and write a store
Your app signs in once, finds the stores it may work on in the Admin API, then reads and writes each store's catalog, orders and stock on the same host.
- Admin APIAccounts, stores, members and roles, billing, subscriptions and custom domains, on api.tanqory.com.292 operations
- Store APIProducts, orders, inventory, customers, discounts, taxes, shipping and the storefront cart and checkout, on api.tanqory.com with the store in the path.1,335 operations
- Storefront GraphQLProducts, prices and stock for a storefront in one query, at POST /v1/stores/{storeId}/graphql on api.tanqory.com.
# First, the Admin API knows every store you may work oncurl https://api.tanqory.com/v1/stores \ -H "Authorization: Bearer $TANQORY_API_KEY"# Then call the Store API for that store, on the same hostcurl https://api.tanqory.com/v1/stores/$STORE_ID/products \ -H "Authorization: Bearer $TANQORY_API_KEY"AI in your app
Give your app the assistant merchants use
Tanqory AI reaches your app through the Tanqory MCP server: the assistant merchants use, with chat that knows the store, search by meaning, product images and the knowledge base. It signs in with OAuth 2.1, not an API key.
- ChatTalk with the store's assistant in a conversation that keeps its context, streamed or in one answer.
- SearchHybrid, semantic or keyword search over your own content.
- Knowledge BaseStore articles and categories the assistant answers from.
- Image GenerationProduct shots and banners from a prompt, saved to the store's media.
- AI Image EditRemove a background or edit an image with a sentence.
- EmbeddingsVectors for text, one at a time or in batches.
- MCP serverConnect Claude and other AI assistants to a store through the Tanqory MCP server, with secure sign-in, and let them act from there.
curl https://api.tanqory.com/v1/mcp \ -H "Authorization: Bearer $OAUTH_ACCESS_TOKEN" \ -H "Content-Type: application/json" \ -H "Accept: application/json, text/event-stream" \ -d '{ "jsonrpc": "2.0", "id": 1, "method": "initialize", "params": { "protocolVersion": "2025-06-18", "capabilities": {}, "clientInfo": { "name": "my-app", "version": "1.0" } } }'MCP over streamable HTTP at api.tanqory.com/v1/mcp. Without a token it answers 401 and names its OAuth metadata.
Tools
Set up in minutes
Get a key, try any operation in the browser, then move to code with the SDK or let your coding agent drive the CLI.
- QuickstartCreate a key, export it as TANQORY_API_KEY and make your first call.
- WorkbenchPick any operation in the reference, fill its fields and send it from the browser.
- TypeScript SDK@tanqory/sdk, generated from the same OpenAPI documents, for browsers, Node.js and React Native, with React hooks.
- Tanqory CLIBuilt for coding agents such as Claude Code: sign in, scaffold a theme and run it on live store data.
sofia@pampa ~/pampa % npm install @tanqory/sdkadded @tanqory/sdksofia@pampa ~/pampa % export TANQORY_API_KEY="your_key_here"sofia@pampa ~/pampa % curl https://api.tanqory.com/v1/stores -H "Authorization: Bearer $TANQORY_API_KEY"{ "data": [ { "name": "Pampa Mate Co.", "subdomain": "pampa-mate" } ] }sofia@pampa ~/pampa % Every group
Browse the whole reference
Each group opens its operations with their parameters, request bodies and responses, straight from the spec.
- Domains40 operations
- Subscriptions33 operations
- Billing24 operations
- Taxes22 operations
- Authentication18 operations
- Stores18 operations
- Authentication - MFA14 operations
- Store Members11 operations
- Infrastructure9 operations
- Email Forwards8 operations
- SSL Certificates7 operations
- Custom Domains6 operations
- Governance6 operations
- Store Roles6 operations
- Auth - Social Accounts5 operations
- Health5 operations
- Store Invitations5 operations
- Authentication - Account Management4 operations
- Authentication - Email Change4 operations
- Authentication - Phone4 operations
- Authentication - Secondary Email4 operations
- DNS4 operations
- Sessions4 operations
- Themes - Catalog4 operations
- Authentication - Avatar & Preferences3 operations
- Authentication - Profile3 operations
- Cloudflare Integration3 operations
- Domain Connect3 operations
- Notifications3 operations
- Public Invitations3 operations
- Store API Keys3 operations
- Activity Logs2 operations
- Authentication - Identity Confirmation2 operations
- Metrics1 operation
- PayPal Webhooks1 operation
- Orders92 operations
- Analytics57 operations
- Taxes48 operations
- Store Taxes34 operations
- Customers33 operations
- Transfers30 operations
- Marketing29 operations
- Customer Segments27 operations
- Shipping Settings26 operations
- Metaobjects24 operations
- Payments23 operations
- Collections22 operations
- Draft Orders22 operations
- Purchase Orders21 operations
- Storefront - Cart & Checkout21 operations
- Subscriptions21 operations
- Stores19 operations
- Gift Cards18 operations
- Shipping Profiles18 operations
- Storefront - Authentication18 operations
- Products16 operations
- Returns16 operations
- Selling Plans15 operations
- Store Discounts15 operations
- Inventory14 operations
- Media Library14 operations
- Themes - Page Templates (Legacy)14 operations
- Mobile13 operations
- Store Settings - Catalogs13 operations
- AI Assistant12 operations
- Blogs12 operations
- Store Members12 operations
- Store Settings - Markets12 operations
- Media Boards11 operations
- Store Settings - Locations11 operations
- AI Usage10 operations
- Computed Traits10 operations
- Domains10 operations
- Product Categories10 operations
- Storefront - Subscriptions10 operations
- Analytics AI9 operations
- Customer Events9 operations
- Infrastructure9 operations
- Pages9 operations
- Payment Providers9 operations
- Store Settings - Webhooks9 operations
- Suppliers9 operations
- Themes - Installation9 operations
- AI Skills8 operations
- Collection Views8 operations
- Gift Card Views8 operations
- Inventory Views8 operations
- Invoice Views8 operations
- Metafields8 operations
- Product Views8 operations
- Purchase Order Views8 operations
- Push Notifications8 operations
- Store Content - Menus8 operations
- Transfer Views8 operations
- Articles7 operations
- Email Forwards7 operations
- Payment Sessions7 operations
- Store Discounts: Timeline7 operations
- Store Settings - Customer Privacy7 operations
- Store Settings - Email Templates7 operations
- Store Settings - Policies7 operations
- Themes - Pages7 operations
- Language Settings6 operations
- Manual Payment Methods6 operations
- Media Usage6 operations
- Order Risks6 operations
- Pixels6 operations
- Shipping Labels6 operations
- Store Credits6 operations
- Store Discounts: Validation6 operations
- Store Roles6 operations
- Store Settings - Staff Notifications6 operations
- Themes - Export & Versions6 operations
- Themes - Layouts6 operations
- Auth5 operations
- Bank Accounts5 operations
- Billing5 operations
- Cloudflare5 operations
- Domain Notifications5 operations
- Health5 operations
- Packages5 operations
- Payouts5 operations
- Store Invitations5 operations
- Storefront - Orders5 operations
- Themes - Blocks5 operations
- Transactions5 operations
- Canva Integration (store)4 operations
- Disputes4 operations
- Orders - Abandoned Checkouts4 operations
- Settings4 operations
- Storage4 operations
- Store Content - Pages4 operations
- Store Discounts: Views4 operations
- Store Settings - Custom Attribute Values4 operations
- Store Settings - Customer Accounts4 operations
- Storefront4 operations
- Themes - Catalog4 operations
- Themes - Styles4 operations
- Webhook Events4 operations
- AI Policy Generation3 operations
- Canva Integration (proxy)3 operations
- Cloudflare Credential3 operations
- DHL Express Integration3 operations
- Easyship Integration3 operations
- Inventory Locations3 operations
- Notifications3 operations
- Product Variants3 operations
- Public Invitations3 operations
- Store API Keys3 operations
- Store Settings - Security3 operations
- AI Email Template Generation2 operations
- Checkout2 operations
- Dashboard Metrics2 operations
- Domain Notification Preferences2 operations
- Events Gateway2 operations
- GraphQL2 operations
- Media AI Edit2 operations
- Media Upload2 operations
- Payment Settings2 operations
- Stock Photos2 operations
- Store Activity2 operations
- Store Content - Articles2 operations
- Store Settings - Brand2 operations
- Store Settings - Checkout2 operations
- Store Settings - Notifications2 operations
- Storefront - Installment Payments2 operations
- Themes - Assets2 operations
- Webhooks2 operations
- Cart1 operation
- Computed Traits Presets1 operation
- Feature Flags1 operation
- Lookup1 operation
- Metrics1 operation
- Policy Templates1 operation
- Search1 operation
- Setup Progress1 operation
- Shipping Provider1 operation
- Storage Usage1 operation
- Store Domains1 operation
- Store Settings - Products1 operation
- Storefront - API Key Validation1 operation
Make your first call today
Open a store, create a key and list your stores in one request. AI is part of every plan.
- One Bearer token for every API
- Generated from the OpenAPI spec
- SDK, CLI and MCP server