Markets API reference

Reference map for Markets API operations.

Updated
Apr 26, 2026

Markets

Use this reference map to choose the operation group before opening an endpoint page for exact request and response details.

Use Markets when the job is about market records and market slugs.

Market operations own market listing, lookup by slug, creation, updates, and deletion. Market records carry regional configuration such as locale, currency code, active status, and country-code coverage.

Use Store Groups, Tax Groups, or Warehouses when an existing market needs to be attached to or removed from a selling, tax, or stock context. Check the delete operation before removing a market because market deletion affects related tax-group relationships and product variant prices.

For workflow guidance across store groups, markets, tax groups, warehouses, product drafts, variants, customer groups, and events, see Store groups and markets.

Read and inspect

OperationAPI
Get a market by slugManagement API
List all marketsManagement API

Create or attach

OperationAPI
Create a new marketManagement API

Update or repair

OperationAPI
Update an existing marketManagement API

Remove or deactivate

OperationAPI
Delete a marketManagement API

Markets API reference

# Markets Use this reference map to choose the operation group before opening an endpoint page for exact request and response details. Use Markets when the job is about market records and market slugs. Market operations own market listing, lookup by slug, creation, updates, and deletion. Market records carry regional configuration such as locale, currency code, active status, and country-code coverage. Use Store Groups, Tax Groups, or Warehouses when an existing market needs to be attached to or removed from a selling, tax, or stock context. Check the delete operation before removing a market because market deletion affects related tax-group relationships and product variant prices. For workflow guidance across store groups, markets, tax groups, warehouses, product drafts, variants, customer groups, and events, see [Store groups and markets](/start/concepts/store-groups-and-markets).

5 operations grouped by the job they support.

## Read and inspect | Operation | API | | --- | --- | | [Get a market by slug](/reference/markets/get-a-market-by-slug) | Management API | | [List all markets](/reference/markets/list-all-markets) | Management API | ## Create or attach | Operation | API | | --- | --- | | [Create a new market](/reference/markets/create-a-new-market) | Management API | ## Update or repair | Operation | API | | --- | --- | | [Update an existing market](/reference/markets/update-an-existing-market) | Management API | ## Remove or deactivate | Operation | API | | --- | --- | | [Delete a market](/reference/markets/delete-a-market) | Management API |