POST
/
api-category
/
v1
/
category
/
find

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.

Body

application/json
include
object

Inclusion criteria

match
object
page
number

Number of pages in the response.

size
number

Number of categories per page.

status
enum<string>

Category status. Only ALTERNATE Hierarchies can be filtered using this paramater. If omitted ACTIVE status is considered by default.

Available options:
ACTIVE,
INACTIVE,
ALL
type
enum<string>

Category type. The primary hierarchy contains all branches, whereas alternate hierarchies exist to export alternate organizations of the primary hierarchy. If omitted ALTERNATE is considered by default.

Available options:
PRIMARY,
ALTERNATE

Response

200 - application/json
categories
object[]
pages
number

Number of pages for the given pageSize

pageSize
number

Number of records (categories) per page

totalSize
number

Total number of records (categories)