Skip to main content
GET
/
api-product
/
v2
/
product
Get items and limited children items
curl --request GET \
  --url https://live.copilot.fabric.inc/api-product/v2/product \
  --header 'Authorization: Bearer <token>' \
  --header 'x-site-context: <x-site-context>'
{
  "totalSize": 100,
  "pageSize": 10,
  "pages": 10,
  "products": [
    {
      "sku": "MOBO-X570",
      "itemId": 4,
      "childrenSize": 0,
      "type": "ITEM",
      "status": true,
      "categories": [
        {
          "id": "621c121bff2e4507c199b7cb",
          "name": "electronics",
          "nodeId": 30,
          "breadcrumbs": [
            {
              "id": "621c10f3ff2e4507c199b66b",
              "nodeId": 31,
              "name": "PRIMARY",
              "attributes": [
                "<any>"
              ]
            }
          ]
        }
      ],
      "attributes": [
        {
          "id": "619a8ba6f1875f6dbcaf0521",
          "name": "notes",
          "description": "Notes for this particular category.",
          "type": "TEXT",
          "value": "Unable to fulfill demand.",
          "mapping": "description"
        }
      ]
    }
  ]
}

Authorizations

​
Authorization
string
header
required

S2S access token (JWT) from fabric Identity service (during Login)

Headers

​
x-site-context
string
required

The x-site-context header is a JSON object that contains information about the source you wish to pull from. The mandatory account is the 24 character identifier found in Copilot. The channel (Sales channel ID), stage (environment name), and date attributes can be used to further narrow the scope of your data source.

Example:

"{\"date\": \"2023-01-01T00:00:00.000Z\", \"channel\": 12, \"account\": \"1234abcd5678efgh9ijklmno\",\"stage\":\"production\"}"

Query Parameters

​
skus
string

Stock Keeping Units (SKUs). <br /> Note: Either skus or itemIds can be used to get specific items. If they are omitted, all items are returned in a paginated response. Using the query parameters page and size, you can narrow down the search results.

​
page
number

Page number to be retrieved. Applicable only in a paginated response and always paired with size.

Example:

1

​
size
number

Number of records per page. Applicable only in a paginated response and always paired with page.

Example:

10

​
status
enum<string>

Item status. <br /> Note: <br /> 1) Returns a paginated response. <br /> 2) When used as the only criteria, must be paired with size and page to narrow down the search results.

Available options:
ACTIVE,
INACTIVE
Example:

"ACTIVE"

​
type
enum<string>

Item type. Note: Set page and size to use this filter.

Available options:
ITEM,
BUNDLE
​
createdAfter
string

Items created after a specific date. Valid date formats are 'YYYY/MM/DD', 'YYYY-MM-DDTHH:mm:ss.SSSZ'. <br /> Note: <br /> 1) Applicable only when skus and itemIds are omitted. <br /> 2) Returns paginated response. <br /> 3) Must be paired with size and page to narrow down the search results.

Example:

"2021-05-28T16:36:50.055Z"

​
createdBefore
string

Items created before a specific date. Valid date formats are 'YYYY/MM/DD', 'YYYY-MM-DDTHH:mm:ss.SSSZ'. <br /> Note: <br /> 1) Applicable only when skus and itemIds are omitted. <br /> 2) Returns paginated response. <br /> 3) Must be paired with size and page narrow down the search results.

Example:

"2021-05-28T16:36:50.055Z"

​
modifiedAfter
string

Items modified after a specific date. Valid date formats are 'YYYY/MM/DD', 'YYYY-MM-DDTHH:mm:ss.SSSZ'. <br /> Note: <br /> 1) Applicable only when skus or itemIds are omitted. <br /> 2) Returns paginated response. <br /> 3) Must be paired with size and page to narrow down the search results.

Example:

"2021-05-28T16:36:50.055Z"

​
modifiedBefore
string

Items modified before a specific date. Valid date formats are 'YYYY/MM/DD', 'YYYY-MM-DDTHH:mm:ss.SSSZ'. <br /> Note: <br /> 1) Applicable only when skus and itemIds are omitted. <br /> 2) Returns paginated response. <br /> 3) Must be paired with size and page to narrow down the search results.

Example:

"2021-05-28T16:36:50.055Z"

​
parentSku
string

Parent SKU to get its children items. <br /> Note <br /> 1) To get a p paginates response, optionally, size and page can be used as query parameters. When they are omitted, this endpoint returns all children. <br /> 2) Only page and size are supported with this query parameter, to narrow down the search results.

Example:

"parent123"

Response

OK

  • Option 1
  • Option 2
  • Option 3
​
totalSize
number

Total number of records (items)

Example:

100

​
pageSize
number

Number of records (items) in a page

Example:

10

​
pages
number

Number of pages for the given pageSize

Example:

10

​
products
object[]