Products

Retrieve all products

get/products

Query parameters

created_at_minstring date-time

Filter by created at date/time at or after given value. Accepts ISO 8601/RFC 3339 format with timezone (e.g., 2025-01-16T14:30:00Z) or date-only (e.g., 2025-01-16). Date-only values use 00:00:00 UTC.

created_at_maxstring date-time

Filter by created at date/time at or before given value. Accepts ISO 8601/RFC 3339 format with timezone (e.g., 2025-01-16T14:30:00Z) or date-only (e.g., 2025-01-16). Date-only values use 23:59:59 UTC.

status'live' | 'test' | 'archived'

Filter product by status

product_category'physical' | 'digital'

Filter product by category

pricing_type'one_time' | 'limited_subscription' | 'recurring_subscription' | 'pwyw_one_time' | 'pwyw_recurring_subscription' | 'pwyw_limited_subscription'

Filter product by pricing type

offsetinteger

The offset value used to paginate through a list of entries. If the dir query parameter is prev then the offset will be the id of the first record of the data set otherwise the offset will be the id of the last record

limitinteger

An optional limit for the number of entries on a page with a maximum value of 100. Default value is 100 if not provided.

dir'next' | 'prev'

The direction to paginate the next set of data. If dir is prev the page will return a data set before the offset otherwise the data set will be after the offset. Default value is next if not provided.

Response

Successful operation. Response will return an array of 0 or more products

Example response

{
  "data": [
    {
      "id": 1337,
      "sku": "sku123",
      "internal_product_name": "internal-book-product",
      "product_name": "Book",
      "description": "This is a good book",
      "currency": "USD",
      "price": 1025,
      "product_category": "physical",
      "pricing_type": "one_time",
      "status": "live",
      "taxes": true,
      "upsell_funnel": "Additional Offer",
      "order_bumps": [
        {
          "product_id": 1234,
          "product_name": "Binder"
        }
      ],
      "bundled_products": [
        {
          "product_id": 3423,
          "product_name": "Magazine"
        }
      ],
      "slug": "book",
      "custom_domain": "https://google.com",
      "product_tags": [
        {
          "name": "digital"
        }
      ],
      "created_at": "2021-01-14 18:03:59",
      "updated_at": "2021-01-14 18:03:59",
      "archived_date": "2021-01-14 18:03:59"
    }
  ],
  "pagination": {
    "next": "https://example.samcart.com/v1/example?offset=1337&dir=next"
  }
}

Changes

No recorded changes to this endpoint across all 1 revision of this API.