GET
/
v1
/
retailers
/
{retailer_id}
/
inventory
/
{id}
/
history
curl --request GET \
  --url https://marketplace-api.fabric.inc/v1/retailers/{retailer_id}/inventory/{id}/history/ \
  --header 'Authorization: Bearer <token>'
{
  "connection": "conn-12345",
  "variant": "SKU-001-BLUE",
  "inventory_policy": "managed",
  "inventory": "150",
  "inventory_updated_at": "2024-04-15T12:00:00Z",
  "inventory_last_submitted_at": "2024-04-15T12:05:00Z",
  "brand_inventory_updated_at": "2024-04-14T08:30:00Z",
  "discontinued": false,
  "discontinued_updated_at": "2024-03-01T10:00:00Z",
  "replenishable": true,
  "sellable": "yes",
  "sellable_updated_at": "2024-04-10T09:15:00Z",
  "estimated_availability_date": "2024-05-01",
  "locations": "Warehouse A, Warehouse B"
}

Authorizations

​
Authorization
string
header
required

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

Path Parameters

​
retailer_id
integer
required

The unique retailer ID. In the Dropship UI this is called the Merchant ID. To find your Merchant ID, click your merchant name in the top nav.

Example:

1001

​
id
integer
required

The unique inventory item identifier. This ID is automatically generated when new inventory is created.

Example:

6006

Response

200 - application/json
OK
​
inventory_updated_at
string
required

Timestamp when the inventory was last updated by the retailer

Example:

"2024-04-15T12:00:00Z"

​
inventory_last_submitted_at
string
required

Timestamp when inventory was last submitted to the platform

Example:

"2024-04-15T12:05:00Z"

​
brand_inventory_updated_at
string
required

Timestamp when the brand last updated the inventory

Example:

"2024-04-14T08:30:00Z"

​
sellable_updated_at
string
required

Timestamp when the sellable status was last updated

Example:

"2024-04-10T09:15:00Z"

​
estimated_availability_date
string
required

Estimated date when the product will be back in stock or available

Minimum length: 1
Example:

"2024-05-01"

​
connection
string

The connection through which the inventory is managed

Example:

"conn-12345"

​
variant
string

The variant (SKU) of the product

Example:

"SKU-001-BLUE"

​
inventory_policy
enum<string>

Determines how inventory is managed for this variant

Available options:
unmanaged,
managed
Example:

"managed"

​
inventory
string

Current available inventory quantity

Example:

"150"

​
discontinued
boolean

Indicates if the product variant is discontinued

Example:

false

​
discontinued_updated_at
string

Timestamp when the discontinued status was last updated

Example:

"2024-03-01T10:00:00Z"

​
replenishable
boolean

Indicates if the product is regularly replenished

Example:

true

​
sellable
string

Indicates if the product is currently sellable

Example:

"yes"

​
locations
string

List of locations where inventory is held, separated by commas.

Example:

"Warehouse A, Warehouse B"