# AgentStack Commerce Merchant API

**Canonical:** https://apis.io/apis/agentstack-tech/agentstack-tech-commerce-merchant-api/  
**Provider:** AgentStack — https://apis.io/providers/agentstack-tech/  
**Documentation:** https://agentstack.tech/api-docs

AgentStack Commerce Merchant API is one of 90 APIs that [AgentStack](https://apis.io/providers/agentstack-tech/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. This API exposes 6 JSON Schema definitions. Tagged areas include Commerce Merchant. The published artifact set on APIs.io includes an OpenAPI specification and 6 JSON Schemas.

Merchant listings, orders, shelf tools. REST compatibility surface; for new integrations prefer MCP actions, GET/POST /api/dna/data, or POST /api/commands (see docs/API_CHANNELS_AND_PROTOCOLS.md).

## Operations (38)

| Method | Path | Summary |
|---|---|---|
| GET | `/api/commerce/merchant/coupons` | Merchant List Coupons |
| POST | `/api/commerce/merchant/coupons` | Merchant Create Coupon |
| PUT | `/api/commerce/merchant/coupons/{code}` | Merchant Update Coupon |
| DELETE | `/api/commerce/merchant/coupons/{code}` | Merchant Delete Coupon |
| GET | `/api/commerce/merchant/dashboard` | Merchant Dashboard |
| GET | `/api/commerce/merchant/hub-snapshot` | Merchant Hub Snapshot |
| GET | `/api/commerce/merchant/listings` | Merchant Listings |
| POST | `/api/commerce/merchant/listings` | Merchant Create Listing |
| GET | `/api/commerce/merchant/orders-incoming` | Merchant Orders Incoming |
| PUT | `/api/commerce/merchant/listings/{listing_uuid}` | Merchant Update Listing |
| POST | `/api/commerce/merchant/listings/{listing_uuid}/sync-price` | Merchant Sync Listing Price |
| POST | `/api/commerce/merchant/listings/{listing_uuid}/reindex` | Merchant Reindex Listing |
| POST | `/api/commerce/merchant/listings/bulk-sync-prices` | Merchant Bulk Sync Prices |
| POST | `/api/commerce/merchant/listings/bulk-deactivate` | Merchant Bulk Deactivate |
| GET | `/api/commerce/merchant/shelf-stats` | Merchant Shelf Stats |
| GET | `/api/commerce/merchant/featured` | Merchant Get Featured |
| PUT | `/api/commerce/merchant/featured` | Merchant Set Featured |
| GET | `/api/commerce/participant/holdings` | Participant Holdings |
| GET | `/api/commerce/participant/wallet-summary` | Participant Wallet Summary |
| POST | `/api/commerce/participant/grant-holding` | Participant Grant Holding |
| POST | `/api/commerce/storefront/seed/plan` | Storefront Seed Plan |
| POST | `/api/commerce/storefront/seed/apply` | Storefront Seed Apply |
| POST | `/api/commerce/storefront/seed/undo` | Storefront Seed Undo |
| POST | `/api/commerce/storefront/seed/one-click-fill` | Storefront Seed One Click Fill |
| POST | `/api/commerce/ai/generate-products` | Commerce Ai Generate Products |
| POST | `/api/commerce/ai/magic-fill` | Commerce Ai Magic Fill |
| POST | `/api/commerce/ai/suggest-field` | Commerce Ai Suggest Field |
| POST | `/api/commerce/storefront/seed/ingest` | Storefront Seed Ingest |
| GET | `/api/commerce/storefront/studio/draft` | Storefront Studio Draft Get |
| PUT | `/api/commerce/storefront/studio/draft` | Storefront Studio Draft Put |
| GET | `/api/commerce/sell/activation` | Sell Activation State |
| POST | `/api/commerce/sell/activate` | Sell Activate |
| POST | `/api/commerce/orders/refund-request` | Commerce Refund Request |
| GET | `/api/commerce/orders/{order_id}/refund-request` | Commerce Refund Status |
| GET | `/api/commerce/entitlements` | List Entitlements |
| GET | `/api/commerce/my-purchases` | My Purchases |
| GET | `/api/commerce/participant/my-purchases` | Participant My Purchases |
| GET | `/api/commerce/events/refund-stream` | Commerce Refund Event Stream |

## Machine-readable artifacts (7)

- **OpenAPI** — https://artifacts.apis.io/agentstack-tech/openapi/agentstack-tech-commerce-merchant-api-openapi.yml
- **JSONSchema** — https://artifacts.apis.io/agentstack-tech/json-schema/agentstack-tech-knowledge-config-patch-schema.json
- **JSONSchema** — https://artifacts.apis.io/agentstack-tech/json-schema/agentstack-tech-create-payment-request-schema.json
- **JSONSchema** — https://artifacts.apis.io/agentstack-tech/json-schema/agentstack-tech-generation-settings-patch-schema.json
- **JSONSchema** — https://artifacts.apis.io/agentstack-tech/json-schema/agentstack-tech-project-data-patch-body-schema.json
- **JSONSchema** — https://artifacts.apis.io/agentstack-tech/json-schema/agentstack-tech-content-metadata-patch-schema.json
- **JSONSchema** — https://artifacts.apis.io/agentstack-tech/json-schema/agentstack-tech-plan-claim-response-schema.json

## Other AgentStack APIs (12)

- [AgentStack 8DNA API](https://apis.io/apis/agentstack-tech/agentstack-tech-8dna-api-api/)
- [AgentStack Admin API](https://apis.io/apis/agentstack-tech/agentstack-tech-admin-api/)
- [AgentStack Admin Drain API](https://apis.io/apis/agentstack-tech/agentstack-tech-admin-drain-api/)
- [AgentStack Agent Net API](https://apis.io/apis/agentstack-tech/agentstack-tech-agentnet-api/)
- [AgentStack AgentNet Arbitrum API](https://apis.io/apis/agentstack-tech/agentstack-tech-agentnet-arbitrum-api/)
- [AgentStack AgentNet BNB API](https://apis.io/apis/agentstack-tech/agentstack-tech-agentnet-bnb-api/)
- [AgentStack AgentNet Chain Control API](https://apis.io/apis/agentstack-tech/agentstack-tech-agentnet-chain-control-api/)
- [AgentStack AgentNet Chain Control Public API](https://apis.io/apis/agentstack-tech/agentstack-tech-agentnet-chain-control-public-api/)
- [AgentStack AgentNet PTR API](https://apis.io/apis/agentstack-tech/agentstack-tech-agentnet-ptr-api/)
- [AgentStack AgentNet Solana API](https://apis.io/apis/agentstack-tech/agentstack-tech-agentnet-solana-api/)
- [AgentStack Agents Fleet API](https://apis.io/apis/agentstack-tech/agentstack-tech-agents-fleet-api/)
- [AgentStack Agent Social API](https://apis.io/apis/agentstack-tech/agentstack-tech-agentsocial-api/)

## Tags

Commerce Merchant

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/agentstack-tech/agentstack-tech-commerce-merchant-api/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/agentstack-tech/.