GET Latest Products

Returns 10 products per page. By default these are the products added to the database in the last 7 days, ordered by date added. With release_date_search=1 the list holds products released between release_date and today, ordered by release date - the way to ask "what dropped since last week". The upcoming products endpoint is the future-side counterpart.

Parameters

Parameter	In	Required	Description
`page`	query	no	Page number.
`sort`	query	no	Sort direction. Any other value falls back to `desc`.
`release_date_search`	query	no	Send `true` or `1` to list by release date instead of by date added. `release_date` is then required.
`release_date`	query	no	Earliest release date, `YYYY-MM-DD`. Must be no more than 14 days in the past. Results run from this date to today.

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/latest

Ability

latest-product

Query Parameters

page (optional, integer >= 1)
sort (optional, asc|desc)
release_date_search (optional, boolean-like)
release_date (required when searching by date, format YYYY-MM-DD)

Response `200` (success)

{
  "error": false,
  "products": [
    {
      "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_added": "datetime|string|null"
    }
  ],
  "pagination": {
    "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 your query.",
  "response_time": "XXXms",
  "request_fulfilled": true,
  "request_debited": false
}

Response `400` or `403`

{
  "error": true,
  "message": "validation/date 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