v1

latestOpenAPI 3.1.02026-07-1342112262.5 KB

Item Categories

Fetch an item category

Required scope: business/catalogue:read

Deprecated alias: business/products:read (still accepted, will be removed in a future release)

get/v1/item_categories/{item_category_id}

Path parameters

item_category_idstring required

The unique identifier of the item category.

Response

Successful Response

idstring required

The unique identifier of the category.

namestring required

The name of the category.

descriptionstring nullable required

A description of the category.

created_atstring date-time required

The category creation date and time in ISO 8601 format.

updated_atstring date-time nullable required

The date and time the category was last modified in ISO 8601 format.

Example response

{
  "created_at": "2024-11-19T15:27:02+00:00",
  "description": "A home for all our tasty warm beverages.",
  "id": "1757511249593-dd25e17c-5541-4276-a078-8c3dcca296de",
  "image": {
    "created_at": "2024-11-19T15:27:02+00:00",
    "id": "1757533814961-58f649da-81e3-4877-8769-f407cfba8aff",
    "mime_type": "image/jpeg",
    "type": "image",
    "updated_at": "2024-11-19T16:27:23+00:00",
    "url": "https://images.yoco.com/foo/bar.jpg"
  },
  "name": "Hot Beverages",
  "parent_category": {
    "created_at": "2024-11-19T15:27:02+00:00",
    "description": "A home for all our beverages.",
    "id": "1757511225824-ab79f3ee-5a21-4bca-a060-ef27d9aae788",
    "image": {
      "created_at": "2024-11-19T15:27:02+00:00",
      "id": "1757533814961-58f649da-81e3-4877-8769-f407cfba8aff",
      "mime_type": "image/jpeg",
      "type": "image",
      "updated_at": "2024-11-19T16:27:23+00:00",
      "url": "https://images.yoco.com/foo/bar.jpg"
    },
    "name": "Beverages",
    "updated_at": "2024-11-19T16:27:23+00:00"
  },
  "updated_at": "2024-11-19T16:27:23+00:00"
}