Skip to main content
GET
/
products
List products
curl --request GET \
  --url https://www.merchkit.com/api/v1/products \
  --header 'Authorization: Bearer <token>'
{
  "data": [
    {
      "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
    }
  ],
  "pagination": {
    "total": 123,
    "limit": 123,
    "offset": 123,
    "has_more": true,
    "next_cursor": "<string>"
  }
}

Authorizations

​
Authorization
string
header
required

Workspace-scoped API key. Available scopes:

  • read:products: List and read products, assets, vendors, sources, and merch.
  • write:products: Create and update products and their attribute values.
  • delete:products: Delete products.
  • read:attributes: List and read attribute definitions.
  • write:attributes: Create, update, and delete attribute definitions.
  • write:attribute_values: Set attribute values on entities.
  • read:views: List and read saved grid views.
  • write:views: Create and update grid views.
  • read:vendors: List and read vendor records.
  • write:vendors: Create and update vendor records.
  • read:categories: List and read categories.
  • write:categories: Create and update categories.
  • read:channels: Read the available channel catalog.
  • read:completeness: Check per-channel completeness for entities.
  • read:history: Read entity history and the account change feed.
  • read:jobs: Poll asynchronous job status.
  • data:import: Start import operations.
  • data:export: Start export operations.

Query Parameters

​
limit
integer
default:50
Required range: x <= 200
​
offset
integer
default:0
​
sort
string

Comma-separated columns; - prefix = descending, e.g. -updated_at,sku.

​
filter_join
enum<string>
default:AND
Available options:
AND,
OR

Response

200 - application/json

A page of products.

​
data
object[]
​
pagination
object