Get products by section

GET 
/api/v2/catalog/sections/products

Returns products grouped by their section

Queries can use the slugs instead of the IDs. When searching by category slug, you must provide the business_id.

Request

Query Parameters

business_id string
Limit results to a specific business
Example: cd9feea7-99f4-4e90-897f-8b4f7cac8c59
category_id string
Limit results to specific categories
Example: 5m4v972ra9ue

Responses

200

application/json

Schema

Schema

• Array [

id stringrequired

Possible values: >= 12 characters and <= 12 characters, Value must match regular expression ^[0-9a-z]+$

Unique ID of the section

name stringrequired

Possible values: non-empty

Name of the section

slug stringrequired

Possible values: non-empty

Slug of the section

order integerrequired

Default value: 0

Used to order the item, order defaults to ascending.

created_at date-timerequired
updated_at date-timerequired

products

object[]

required

Array [

id stringrequired

Possible values: >= 12 characters and <= 12 characters, Value must match regular expression ^[0-9a-z]+$

Unique ID of the product

category_id stringrequired

Category ID of the product

section_id stringrequired

Section ID of the product

name stringrequired

Possible values: non-empty

Name of the product

slug stringrequired

Possible values: non-empty

Slug of the product

description stringrequired

Description of the product

sku stringnullable

The SKU of the product

ref_code stringnullable

The reference code of the product

photo_url urinullable

The photo URL of the product

price +decimalrequired

The price of the product

available booleanrequired

Default value: true

Mark the product as not available

order integerrequired

Default value: 0

Used to order the item, order defaults to ascending.

created_at date-timerequired

updated_at date-timerequired

]

• ]

Example (from schema)

[
  {
    "id": "u7m4f8ep5nfi",
    "name": "Pizza",
    "slug": "pizza",
    "order": 1,
    "created_at": "2024-08-13T11:41:41.361Z",
    "updated_at": "2024-08-13T11:41:41.361Z",
    "products": [
      {
        "id": "bk8h0y2r68ke",
        "category_id": "5m4v972ra9ue",
        "section_id": "u7m4f8ep5nfi",
        "name": "Pizza",
        "slug": "pizza",
        "description": "A delicious pizza",
        "sku": "123456",
        "ref_code": "123456",
        "photo_url": "https://example.com/photo.jpg",
        "price": "12.5",
        "available": true,
        "order": 1,
        "created_at": "2024-08-13T11:41:41.361Z",
        "updated_at": "2024-08-13T11:41:41.361Z"
      }
    ]
  }
]

400

application/json

Schema

Schema

statusCode integerrequired

HTTP status code

message string

Error message

error string

Error name

Example (from schema)

{
  "statusCode": 404,
  "message": "Cannot find item",
  "error": "Not Found"
}

401

application/json

Schema

Schema

statusCode integerrequired

HTTP status code

message string

Error message

error string

Error name

Example (from schema)

{
  "statusCode": 404,
  "message": "Cannot find item",
  "error": "Not Found"
}

403

application/json

Schema

Schema

statusCode integerrequired

HTTP status code

message string

Error message

error string

Error name

Example (from schema)

{
  "statusCode": 404,
  "message": "Cannot find item",
  "error": "Not Found"
}

404

application/json

Schema

Schema

statusCode integerrequired

HTTP status code

message string

Error message

error string

Error name

Example (from schema)

{
  "statusCode": 404,
  "message": "Cannot find item",
  "error": "Not Found"
}

422

application/json

Schema

Schema

statusCode integerrequired

HTTP status code

message string

Error message

errors

object[]

required

Array [

path stringrequired

Possible values: non-empty

Path to the property with the error

errors

object[]

required

Array [

type stringrequired

Possible values: non-empty

Error type

message stringrequired

Error message

]

]

Example (from schema)

{
  "statusCode": 404,
  "message": "Cannot find item",
  "errors": [
    {
      "path": "business.id",
      "errors": [
        {
          "type": "object_required_property",
          "message": "Required property"
        }
      ]
    }
  ]
}

500

application/json

Schema

Schema

statusCode integerrequired

HTTP status code

message string

Error message

error string

Error name

Example (from schema)

{
  "statusCode": 404,
  "message": "Cannot find item",
  "error": "Not Found"
}

Loading...