GET/api/v1/products

List products

Returns every product the authenticated merchant has published. Includes variants and primary image.

Authorization

Requires the products:read scope. See the auth guide for how to mint a token with the right scopes.

Parameters

Query parameters

Field	Type	Description
cursor optional	string	Pagination cursor returned in the previous response's `nextCursor`. Omit to start from the beginning. e.g. c1a2b3c4
limit optional	number	Page size. 1–100, default 25. e.g. 25

Response

A successful call returns 200 OK with the body shown to the right. Errors follow the standard envelope.

Request

curl 'https://theyutes.com/api/v1/products' \
  -H 'Authorization: Bearer tyk_••••••••••••••••••••••••••••••••'

Response · 200 OK

json

{
  "data": [
    {
      "id": "prod_001",
      "title": "Ankara Wrap Skirt",
      "slug": "ankara-wrap-skirt",
      "status": "active",
      "basePriceKobo": 4500000,
      "variants": [
        {
          "id": "var_001",
          "size": "M",
          "color": "Burnt Orange",
          "priceKobo": 4500000,
          "stock": 12
        }
      ]
    }
  ],
  "pagination": {
    "cursor": "c1a2b3c4",
    "limit": 25,
    "hasMore": false
  }
}