Skip to main content
GET
/
categories
/
{id}
Get a Single Category
curl --request GET \
  --url https://api.fabric.inc/v3/categories/{id} \
  --header 'Authorization: Bearer <token>'
{
  "id": "53184766610c0e32a86d875",
  "name": "Color",
  "localizedProperties": {
    "en-US": {
      "name": "Color"
    },
    "en-IN": {
      "name": "Colour"
    }
  },
  "isLocalizable": true,
  "isRoot": true,
  "isLeaf": false,
  "hasProducts": true,
  "categoryAttributes": [
    {
      "id": "64184766610c0e32a86d8758",
      "name": "color",
      "localizedProperties": {
        "en-US": {
          "name": "Color"
        },
        "en-IN": {
          "name": "Colour"
        }
      },
      "isLocalizable": true,
      "isInherited": true,
      "type": "TEXT",
      "validation": {
        "dateFormat": "MM-DD-YYYY"
      },
      "value": "blue"
    }
  ],
  "productAttributes": [
    {
      "id": "33184766610c0e32a86d8759",
      "name": "Color",
      "localizedProperties": {
        "en-US": {
          "name": "Color"
        },
        "en-IN": {
          "name": "Colour"
        }
      },
      "isLocalizable": true,
      "isInherited": true,
      "type": "TEXT",
      "isMandatory": true
    }
  ],
  "productIds": [
    "64184766610c0e32a86d8758"
  ],
  "children": [
    {
      "id": "33184766610c0e32a86d8759",
      "name": "Color",
      "localizedProperties": {
        "en-US": {
          "name": "Color"
        },
        "en-IN": {
          "name": "Colour"
        }
      },
      "isLocalizable": true,
      "isLeaf": false,
      "hasProducts": true
    }
  ],
  "updatedBy": "[email protected]",
  "updatedAt": "2023-04-20T10:24:36.162Z",
  "createdAt": "2021-04-20T10:24:36.162Z"
}

Authorizations

​
Authorization
string
header
required

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

Headers

​
x-fabric-tenant-id
string

A header used by fabric to identify the tenant making the request. You must include tenant id in the authentication header for an API request to access any of fabric’s endpoints. You can retrieve the tenant id , which is also called account id, from Copilot. This header is required.

Example:

"517fa9dfd42d8b00g1o3k312"

​
x-fabric-request-id
string

Unique request ID

Example:

"263e731c-45c8-11ed-b878-0242ac120002"

Path Parameters

​
id
string
required

24-character system-generated category ID

Query Parameters

​
locales
string

Comma-separated locale codes of category. The service throws a 400 error if locale isn't supported. Standard locales can be found at https://www.rfc-editor.org/rfc/rfc5646. The recommended way to get the locale is by invoking multi-channel service

Example:

"fr-CA, en-US"

Response

OK

Category details

​
id
string

24-character system-generated category ID

Example:

"53184766610c0e32a86d875"

​
name
string

Non-localized category name

Example:

"Color"

​
localizedProperties
object

Localized properties of category

Example:
{
  "en-US": { "name": "Color" },
  "en-IN": { "name": "Colour" }
}
​
isLocalizable
boolean

true: Category name is translated into different languages or localized for different regions
false: Category name isn't localized Note: Refer to localizedProperties to get relevant details based on locale

Example:

true

​
isRoot
boolean

true: This is a root category
false: This isn't a root category

Example:

true

​
isLeaf
boolean

true: This is the last category of the branch with no further children categories
false: This isn't the last category of the branch and has children categories

Example:

false

​
hasProducts
boolean

true: This is the leaf category of the branch which has some products in it
false: This branch doesn't have any direct products assigned to it

Example:

true

​
categoryAttributes
object[]

Attributes assigned to the specified category

​
productAttributes
object[]

Attributes assigned for all products in the specified category.

​
productIds
string[]

System-generated 24-character product IDs associated with a category

​
children
object[]

Immediate children of the specified category

​
updatedBy
string

Email of user who last update the category

Example:

"[email protected]"

​
updatedAt
string

Time of last update to category

Example:

"2023-04-20T10:24:36.162Z"

​
createdAt
string

Time of category creation

Example:

"2021-04-20T10:24:36.162Z"