Skip to main content
GET
/
products
Products
curl --request GET \
  --url https://api.marzipan.co/v1/products \
  --header 'Authorization: Bearer <token>'
{
  "data": [
    {
      "id": "2e2805a1-738e-4118-8a8b-f9431f0e210c",
      "name": "Cellar Selection Malbec",
      "slug": "cellar-selection-malbec-2015",
      "description": "Id laboris ad aliqua exercitation dolore. Ad, aliqua exercitation dolore est culpa. Dolore est culpa id duis duis labore dolore do ex.",
      "productType": "physical",
      "sku": "CSMALBC2015",
      "collection": "Store",
      "status": "active",
      "image": {
        "id": "0736c529-a33d-4b8c-8126-eb69779dcdad",
        "path": "1/0736c529-a33d-4b8c-8126-eb69779dcdad.jpg",
        "src": "https://marzipan-cloud-dev.b-cdn.net/1/0736c529-a33d-4b8c-8126-eb69779dcdad.jpg",
        "alt": "Cellar Selection Malbec 2015 bottle",
        "mimeType": "image/jpeg",
        "filename": "0736c529-a33d-4b8c-8126-eb69779dcdad.jpg"
      },
      "price": "£24.99",
      "salePrice": null,
      "subscriberPrice": null,
      "createdAt": "2024-02-05T23:22:56.000000Z",
      "updatedAt": "2024-02-05T23:22:56.000000Z",
      "storeSlug": "store",
      "subscriptionsSlug": null,
      "availability": "all",
      "upsellProducts": []
    },
    {
      "id": "df0d13db-1332-4461-b3d1-b2774d47ff5f",
      "name": "Chardonnay",
      "slug": "chardonnay-2015",
      "description": "Lorem sed id, culpa. Culpa id duis duis labore dolore do ex. Duis duis labore, dolore.",
      "productType": "physical",
      "sku": "CHARD2015",
      "collection": "Store",
      "status": "active",
      "image": {
        "id": "1b978a90-3ecb-4f37-b480-9fb81882176e",
        "path": "1/1b978a90-3ecb-4f37-b480-9fb81882176e.jpg",
        "src": "https://marzipan-cloud-dev.b-cdn.net/1/1b978a90-3ecb-4f37-b480-9fb81882176e.jpg",
        "alt": "Chardonnay 2015 bottle",
        "mimeType": "image/jpeg",
        "filename": "1b978a90-3ecb-4f37-b480-9fb81882176e.jpg"
      },
      "price": "£23.99",
      "salePrice": null,
      "subscriberPrice": null,
      "createdAt": "2024-02-05T23:22:56.000000Z",
      "updatedAt": "2024-02-05T23:22:56.000000Z",
      "storeSlug": "store",
      "subscriptionsSlug": null,
      "availability": "all",
      "upsellProducts": []
    },
    {
      "id": "084b80ef-d16d-4531-a25f-40b7ff4c744b",
      "name": "Discovery Club",
      "slug": "discovery-club",
      "description": "Laborum adipiscing, tempor cillum. Cillum exercitation sed officia mollit do dolore.",
      "productType": "subscription",
      "sku": "DISCCLUB",
      "collection": "Club",
      "status": "active",
      "image": {
        "id": "bc1a0d61-e7f9-44d3-ae53-1475b5f9395d",
        "path": "1/bc1a0d61-e7f9-44d3-ae53-1475b5f9395d.jpg",
        "src": "https://marzipan-cloud-dev.b-cdn.net/1/bc1a0d61-e7f9-44d3-ae53-1475b5f9395d.jpg",
        "alt": "Discovery Club subscription box",
        "mimeType": "image/jpeg",
        "filename": "bc1a0d61-e7f9-44d3-ae53-1475b5f9395d.jpg"
      },
      "price": "from £0.00",
      "salePrice": null,
      "subscriberPrice": null,
      "createdAt": "2024-02-05T23:22:56.000000Z",
      "updatedAt": "2024-02-05T23:22:56.000000Z",
      "storeSlug": null,
      "subscriptionsSlug": "club",
      "availability": "all",
      "upsellProducts": [],
      "billing_frequency": 6,
      "pricing_type": "per_item"
    }
  ],
  "links": {
    "first": "https://api.marzipan.co/v1/products?page=1",
    "last": "https://api.marzipan.co/v1/products?page=5",
    "prev": null,
    "next": "https://api.marzipan.co/v1/products?page=2"
  },
  "meta": {
    "currentPage": 1,
    "from": 1,
    "path": "https://api.marzipan.co/v1/products",
    "perPage": 15,
    "to": 15
  }
}

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your API token.

Query Parameters

​
collection
string

Filter products by collection slug or name. Products will be ordered by their position in the collection.

​
attr
object

Filter products by attributes using deep object notation. Each attribute filter accepts comma-separated values for OR matching.

Format: attr[attribute_slug]=value1,value2

Example: attr[color]=red,blue&attr[size]=large This returns products that are (red OR blue) AND large.

​
sort
string

Sort products by field and direction. Format: field.direction (e.g., price.asc, name.desc). Multiple sort options can be comma-separated.

​
limit
integer

Limit the number of results returned. Maximum 50 per page.

Required range: 1 <= x <= 50
​
page
integer

Page number for pagination.

Required range: x >= 1
​
per_page
integer
default:50

Number of items per page. Default is 50.

Required range: 1 <= x <= 50
​
include
enum<string>

Comma-separated list of related resources to include in the response.

Available options: linkedSubscriptions (includes full subscription details for products with linked subscriptions).

Available options:
linkedSubscriptions

Response

200 - application/json

products

​
data
object[]
​
links
object
​
meta
object