GET
/
v1
/
retailers
/
{retailer_id}
/
products
/
{id}
/
Get a product by ID
curl --request GET \
  --url https://marketplace-api.fabric.inc/v1/retailers/{retailer_id}/products/{id}/ \
  --header 'Authorization: Bearer <token>'
{
  "variant": {
    "id": 100024,
    "name": "T-Shirt, Blue, L",
    "brand": {
      "id": 500,
      "name": "Marla Cielo",
      "code": "demo-brand",
      "joined_at": "2022-09-10T15:24:56Z",
      "logo_url": "https://images.revcascade.com/retailers/defaults/logo-lg.png",
      "cover_url": "https://images.revcascade.com/retailers/defaults/cover.png",
      "profile_tile_url": "https://images.revcascade.com/retailers/defaults/profile-tile.png",
      "website": null,
      "is_onboarded": false,
      "is_on_rcn": false,
      "requires_subscription": "enabled",
      "subscription_expires_at": "2024-09-19T13:32:10Z",
      "grace_period_ends_at": "2024-10-26T13:32:10Z",
      "subscription_is_expired": false,
      "subscription_is_on_grace_period": false,
      "subscription_is_delinquent": false,
      "inventory_policy": "managed",
      "status": "active"
    },
    "brand_identifier": "1000-BL-L",
    "identifier": "5000001",
    "upc": 9119119111,
    "cartons": [
      {
        "id": 48,
        "number": 1,
        "length": "1",
        "length_unit": "1",
        "width": "1",
        "width_unit": "meter",
        "height": "1",
        "height_unit": "meter",
        "weight": "15",
        "weight_unit": "KG",
        "package_girth_inches": "1",
        "package_size_inches": "1"
      }
    ],
    "color": "Red",
    "style": "Print",
    "size": "Large",
    "media": [
      {
        "id": 249,
        "width": 100,
        "height": 100,
        "media": "default",
        "priority": 1,
        "url": "192.168.99.100/media/default/original",
        "updated_at": "2022-09-10T15:24:56Z",
        "created_at": "2022-08-10T15:24:56Z"
      }
    ],
    "attributes": [
      {
        "id": 44,
        "code": "size",
        "name": "Size",
        "editable_by": "brand",
        "grouping": "general",
        "description": "demo product description",
        "type": "money",
        "units": "USD",
        "values": {
          "id": 123,
          "value": "<string>",
          "unit": {
            "id": 677,
            "name": "Sample unit",
            "standard_unit": "<string>",
            "type": "cost",
            "system": "metric",
            "symbol": "USD"
          },
          "retailer": {
            "id": 500,
            "name": "Demo Retailer",
            "code": "demo-retailer",
            "logo_url": "https://images.demo.com/retailers/5ef41f6c-3361-40b7-86ce-ecd79c52e9a2/store/logo-lg.png",
            "cover_url": "https://images.sampke.com/retailers/5ef41f6c-3361-40b7-86ce-ecd79c52e9a2/store/cover.jpg",
            "profile_tile_url": "https://images.demo.com/retailers/5ef41f6c-3361-40b7-86ce-ecd79c52e9a2/store/profile-tile.jpg",
            "joined_at": "2021-08-03T17:24:12Z",
            "is_rcn_retailer": false,
            "is_onboarded": false,
            "platform": "fabric",
            "requires_subscription": "disabled",
            "brand_permit_creation_allowed": false,
            "website": "https://demoabc.com",
            "status": "active"
          },
          "updated_at": "2023-11-07T05:31:56Z",
          "created_at": "2023-11-07T05:31:56Z"
        }
      }
    ],
    "ruleset_variants": [
      {
        "id": 1232,
        "status": "processing",
        "results": "<string>",
        "created_at": "2022-08-10T15:24:56Z",
        "updated_at": "2022-09-10T15:24:56Z"
      }
    ],
    "ruleset_variant_summary": "21",
    "active_permit": {
      "id": 10104,
      "retailer": {
        "id": 500,
        "name": "Demo Retailer",
        "code": "demo-retailer",
        "logo_url": "https://images.demo.com/retailers/5ef41f6c-3361-40b7-86ce-ecd79c52e9a2/store/logo-lg.png",
        "cover_url": "https://images.sampke.com/retailers/5ef41f6c-3361-40b7-86ce-ecd79c52e9a2/store/cover.jpg",
        "profile_tile_url": "https://images.demo.com/retailers/5ef41f6c-3361-40b7-86ce-ecd79c52e9a2/store/profile-tile.jpg",
        "joined_at": "2021-08-03T17:24:12Z",
        "is_rcn_retailer": false,
        "is_onboarded": false,
        "platform": "fabric",
        "requires_subscription": "disabled",
        "brand_permit_creation_allowed": false,
        "website": "https://demoabc.com",
        "status": "active"
      },
      "retailer_price": "12.99",
      "retailer_cost": "8.99",
      "pricing": {},
      "attributes": {},
      "start_at": "2021-09-10T15:24:56Z",
      "end_at": "2024-09-10T15:24:56Z",
      "is_in_effect": true,
      "revoked_at": "2022-09-10T15:24:56Z",
      "is_acknowledged": true,
      "acknowledged_at": "2022-09-10T15:24:56Z"
    },
    "permits": [
      {
        "id": 10104,
        "retailer": {
          "id": 500,
          "name": "Demo Retailer",
          "code": "demo-retailer",
          "logo_url": "https://images.demo.com/retailers/5ef41f6c-3361-40b7-86ce-ecd79c52e9a2/store/logo-lg.png",
          "cover_url": "https://images.sampke.com/retailers/5ef41f6c-3361-40b7-86ce-ecd79c52e9a2/store/cover.jpg",
          "profile_tile_url": "https://images.demo.com/retailers/5ef41f6c-3361-40b7-86ce-ecd79c52e9a2/store/profile-tile.jpg",
          "joined_at": "2021-08-03T17:24:12Z",
          "is_rcn_retailer": false,
          "is_onboarded": false,
          "platform": "fabric",
          "requires_subscription": "disabled",
          "brand_permit_creation_allowed": false,
          "website": "https://demoabc.com",
          "status": "active"
        },
        "retailer_price": "12.99",
        "retailer_cost": "8.99",
        "pricing": {},
        "attributes": {},
        "start_at": "2021-09-10T15:24:56Z",
        "end_at": "2024-09-10T15:24:56Z",
        "is_in_effect": true,
        "revoked_at": "2022-09-10T15:24:56Z",
        "is_acknowledged": true,
        "acknowledged_at": "2022-09-10T15:24:56Z"
      }
    ],
    "is_compatible": true,
    "proposal_variant": {
      "id": 3456,
      "pricing": "12.00",
      "attributes": [
        {
          "id": 123,
          "value": "<string>",
          "unit": {
            "id": 677,
            "name": "Sample unit",
            "standard_unit": "<string>",
            "type": "cost",
            "system": "metric",
            "symbol": "USD"
          },
          "retailer": {
            "id": 500,
            "name": "Demo Retailer",
            "code": "demo-retailer",
            "logo_url": "https://images.demo.com/retailers/5ef41f6c-3361-40b7-86ce-ecd79c52e9a2/store/logo-lg.png",
            "cover_url": "https://images.sampke.com/retailers/5ef41f6c-3361-40b7-86ce-ecd79c52e9a2/store/cover.jpg",
            "profile_tile_url": "https://images.demo.com/retailers/5ef41f6c-3361-40b7-86ce-ecd79c52e9a2/store/profile-tile.jpg",
            "joined_at": "2021-08-03T17:24:12Z",
            "is_rcn_retailer": false,
            "is_onboarded": false,
            "platform": "fabric",
            "requires_subscription": "disabled",
            "brand_permit_creation_allowed": false,
            "website": "https://demoabc.com",
            "status": "active"
          },
          "updated_at": "2023-11-07T05:31:56Z",
          "created_at": "2023-11-07T05:31:56Z"
        }
      ],
      "memos": [
        {
          "id": 1234,
          "text": "Immediate requirement",
          "visibility": "any",
          "acknowledged_at": "2022-01-10T15:24:56Z",
          "notify_people": true,
          "created_by": {
            "id": 542,
            "first_name": "Sample",
            "last_name": "Demo",
            "title": "Demo",
            "status": "Active",
            "type": "standard",
            "photo_url": "https://assets.demo.com/attachments/path_to_attachment/attachment.pdf",
            "profile_photo": "https://assets.demo.com/attachments/path_to_attachment/attachment.pdf",
            "is_me": true
          },
          "created_by_context": "retailer",
          "created_at": "2021-09-10T15:24:56Z",
          "updated_at": "2022-09-10T15:24:56Z"
        }
      ],
      "issues": [
        {
          "id": 123,
          "memos": [
            {
              "id": 1234,
              "text": "Immediate requirement",
              "visibility": "any",
              "acknowledged_at": "2022-01-10T15:24:56Z",
              "notify_people": true,
              "created_by": {
                "id": 542,
                "first_name": "Sample",
                "last_name": "Demo",
                "title": "Demo",
                "status": "Active",
                "type": "standard",
                "photo_url": "https://assets.demo.com/attachments/path_to_attachment/attachment.pdf",
                "profile_photo": "https://assets.demo.com/attachments/path_to_attachment/attachment.pdf",
                "is_me": true
              },
              "created_by_context": "retailer",
              "created_at": "2021-09-10T15:24:56Z",
              "updated_at": "2022-09-10T15:24:56Z"
            }
          ],
          "created_at": "2023-11-07T05:31:56Z",
          "updated_at": "2023-11-07T05:31:56Z",
          "resolved_at": "2023-11-07T05:31:56Z",
          "is_resolved": "<string>",
          "issue_id": 123,
          "message": "<string>",
          "title": "<string>"
        }
      ],
      "variant_id": 249,
      "approved_at": "2022-10-10T15:24:56Z",
      "created_at": "2022-07-10T15:24:56Z",
      "updated_at": "2022-09-10T15:24:56Z",
      "rejected_at": null,
      "reject_reason": "Incomplete",
      "reject": true,
      "approve": false,
      "delete": false
    },
    "retailer_identifiers": {
      "id": 5642,
      "retailer": {
        "id": 500,
        "name": "Demo Retailer",
        "code": "demo-retailer",
        "logo_url": "https://images.demo.com/retailers/5ef41f6c-3361-40b7-86ce-ecd79c52e9a2/store/logo-lg.png",
        "cover_url": "https://images.sampke.com/retailers/5ef41f6c-3361-40b7-86ce-ecd79c52e9a2/store/cover.jpg",
        "profile_tile_url": "https://images.demo.com/retailers/5ef41f6c-3361-40b7-86ce-ecd79c52e9a2/store/profile-tile.jpg",
        "joined_at": "2021-08-03T17:24:12Z",
        "is_rcn_retailer": false,
        "is_onboarded": false,
        "platform": "fabric",
        "requires_subscription": "disabled",
        "brand_permit_creation_allowed": false,
        "website": "https://demoabc.com",
        "status": "active"
      },
      "identifier": "SKU976",
      "name": "Retailer Sample"
    },
    "retailer_categories": {
      "id": 453,
      "retailer": {
        "id": 500,
        "name": "Demo Retailer",
        "code": "demo-retailer",
        "logo_url": "https://images.demo.com/retailers/5ef41f6c-3361-40b7-86ce-ecd79c52e9a2/store/logo-lg.png",
        "cover_url": "https://images.sampke.com/retailers/5ef41f6c-3361-40b7-86ce-ecd79c52e9a2/store/cover.jpg",
        "profile_tile_url": "https://images.demo.com/retailers/5ef41f6c-3361-40b7-86ce-ecd79c52e9a2/store/profile-tile.jpg",
        "joined_at": "2021-08-03T17:24:12Z",
        "is_rcn_retailer": false,
        "is_onboarded": false,
        "platform": "fabric",
        "requires_subscription": "disabled",
        "brand_permit_creation_allowed": false,
        "website": "https://demoabc.com",
        "status": "active"
      },
      "category": "CategoryANC"
    },
    "inventory": {
      "discontinued": true,
      "discontinued_updated_at": null,
      "inventory": 0,
      "inventory_updated_at": "2022-09-10T15:24:56Z",
      "inventory_last_submitted_at": "2022-09-10T15:24:56Z",
      "brand_inventory_updated_at": "2022-09-10T15:24:56Z",
      "sellable": "No",
      "sellable_updated_at": "2022-11-10T15:24:56Z",
      "replenishable": true,
      "estimated_availability_date": "2022-09-10T15:24:56Z",
      "locations": [
        {
          "id": 1,
          "address": {
            "id": 10,
            "type": "residential",
            "name1": "Demo Brand, Inc",
            "name2": null,
            "street1": "1332 Hermosa Ave",
            "street2": null,
            "city": "Hermosa Beach",
            "province": "CA",
            "postal_code": "90254",
            "country": "US",
            "phone1": "3105551212",
            "phone2": "3105551213",
            "fax": null,
            "email": null,
            "federal_tax_id": null
          },
          "inventory": 0,
          "nickname": "LA Warehouse"
        }
      ]
    }
  },
  "inventory_policy": "managed",
  "inventory": 0,
  "inventory_updated_at": "2021-09-10T15:24:56Z",
  "inventory_last_submitted_at": "2022-09-10T15:24:56Z",
  "brand_inventory_updated_at": "2022-09-10T15:24:56Z",
  "discontinued": false,
  "discontinued_updated_at": null,
  "replenishable": true,
  "sellable": "No",
  "sellable_updated_at": "2022-09-10T15:24:56Z",
  "estimated_availability_date": null,
  "locations": [
    {
      "id": 1,
      "address": {
        "id": 10,
        "type": "residential",
        "name1": "Demo Brand, Inc",
        "name2": null,
        "street1": "1332 Hermosa Ave",
        "street2": null,
        "city": "Hermosa Beach",
        "province": "CA",
        "postal_code": "90254",
        "country": "US",
        "phone1": "3105551212",
        "phone2": "3105551213",
        "fax": null,
        "email": null,
        "federal_tax_id": null
      },
      "inventory": 0,
      "nickname": "LA Warehouse"
    }
  ]
}

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 product ID. This ID is automatically generated when a product is created or imported. To find your Product ID, click Products in the top nav > Products. On the Products page, search or filter for the product and select it. The Product Detail page is displayed. You will find the product number at the end of the HTTP URL.

Example:

7007

Response

200 - application/json

Ok

​
inventory_updated_at
string<date-time>
required

Time of inventory update (UTC format)

Example:

"2021-09-10T15:24:56Z"

​
inventory_last_submitted_at
string<date-time>
required

Time of inventory submit (UTC format)

Example:

"2022-09-10T15:24:56Z"

​
brand_inventory_updated_at
string<date-time>
required

Time of vendor inventory update (UTC format)

Example:

"2022-09-10T15:24:56Z"

​
sellable_updated_at
string<date-time>
required

Time variant was marked sellable (UTC format)

Example:

"2022-09-10T15:24:56Z"

​
estimated_availability_date
string
required

Estimated availability date of variant

Minimum length: 1
Example:

null

​
variant
object
​
inventory_policy
enum<string>

Specifies how inventory is managed for the product.

Available options:
unmanaged,
managed
Example:

"managed"

​
inventory
integer

Count of variant available for sale

Example:

0

​
discontinued
boolean

true: Variant is discontinued | false: Variant is active

Example:

false

​
discontinued_updated_at
string<date-time>

Time variant marked discontinued (UTC format)

Example:

null

​
replenishable
boolean

true: Variant is replenishable | false: Variant is not replenishable

Example:

true

​
sellable
string

true: Variant is sellable | false: Variant is not sellable

Example:

"No"

​
locations
object[]