GET Upcoming Products

Lists products with a release date after today and up to the end of next year, soonest first. Use it for release calendars, "coming soon" sections and alerts on future drops. The latest products endpoint is its counterpart for records already released.

Parameters

Parameter	In	Required	Description
`results`	query	no	Results per page.
`page`	query	no	Page number.
`show_data`	query	no	Send `1` to add the raw source payload (`product_data`) to each product.

Billing behaviour

A successful call debits one request from the plan allowance. A call that finds nothing is fulfilled but not debited.

Route

/api/v2/product/upcoming

Ability

upcoming-product

Query Parameters

results (optional, int 1-50)
page (optional, int >= 1)

Response `200` (success)

{
  "error": false,
  "results": [
    {
      "product_name": "string|null",
      "product_brand": "string|null",
      "product_category": "string|null",
      "product_unique_id": "string|null",
      "product_style_code": "string|null",
      "product_release_date": "YYYY-MM-DD|string|null",
      "product_description": "string|null",
      "product_colorway": "string|null",
      "product_retail_price": "string|number|null",
      "product_image": "https://.../api/image/uid/{product_unique_id}"
    }
  ],
  "pagination": {
    "total": "stringified integer",
    "current_page": "stringified integer",
    "next_page": "stringified integer|null",
    "has_next_page": true
  },
  "response_time": "XXXms",
  "request_fulfilled": true,
  "request_debited": true
}

Response `200` (no matches)

{
  "error": true,
  "message": "No products could be found for this search query.",
  "response_time": "XXXms",
  "request_fulfilled": true,
  "request_debited": false
}

Response `400` or `403`

{
  "error": true,
  "message": "validation errors object or token depleted message",
  "response_time": "XXXms",
  "request_fulfilled": false,
  "request_debited": false
}

The barcode lookup API page shows the plans and examples.

On this page