List product categories

A page of the product categories Sibi sells into, each carrying the suppliers that offer products in it, ordered alphabetically. Page by passing the previous response’s next back as after; next is null once a page comes back short.

GET/product-categories

Authorization

AuthorizationBearer token · headerrequired

A Sibi Public API token or access token, sent as Authorization: Bearer <token>.

Scopes:read:product-categories

Query parameters

firstinteger

Maximum number of categories to return per page

max 100 · default: 10

supplierstring | string[]

Supplier slug to restrict the page to. Repeat the param to list the categories any of those suppliers offer products in.

afterstring

Opaque pagination cursor from a previous response next. Omit for the first page.

Responses

200

Product categories the caller is authorized to view

itemsProductCategory[]required

Show properties

Array of ProductCategory

namestringrequired

Human-readable category name.

suppliersstring[]required

Suppliers that offer unarchived products in this category

nextstring | nullrequired

Opaque cursor for the next page; pass it as after. Null when the page came back short, i.e. there is probably nothing behind it.

400

A query parameter this operation does not accept (UNKNOWN_QUERY_PARAMETER), invalid input parameters (VALIDATION_ERROR), or after is not a cursor this endpoint issued (INVALID_CURSOR)

Any of:

ProductCategoriesValidationErrorResponse

codestringrequired

UNKNOWN_QUERY_PARAMETER when every problem is a query parameter this operation does not accept; VALIDATION_ERROR otherwise

Allowed:VALIDATION_ERRORUNKNOWN_QUERY_PARAMETER

messagestringrequired

detailsobject[]required

Per-field validation errors

Show properties

Array of object

fieldstringrequired

errorstringrequired

requestIdstring

Request id for this call — quote it when contacting support

object

codestringrequired

Machine-readable error code

Allowed:INVALID_CURSOR

messagestringrequired

requestIdstring

Request id for this call — quote it when contacting support

401

The Authorization header is missing, or the bearer token could not be resolved (invalid, expired, or revoked)

codestringrequired

Machine-readable error code

Allowed:UNAUTHORIZED

messagestringrequired

requestIdstring

Request id for this call — quote it when contacting support

403

The token is not a Public REST API token (REST_TOKEN_REQUIRED), it is missing the scope this operation requires (INSUFFICIENT_SCOPE), or it was minted for the other environment (TOKEN_ENVIRONMENT_MISMATCH)

codestringrequired

Machine-readable error code

Allowed:REST_TOKEN_REQUIREDINSUFFICIENT_SCOPETOKEN_ENVIRONMENT_MISMATCH

messagestringrequired

requestIdstring

Request id for this call — quote it when contacting support

500

Internal server error

codestringrequired

Machine-readable error code

Allowed:INTERNAL_SERVER_ERROR

messagestringrequired

requestIdstring

Request id for this call — quote it when contacting support

Request

curl -X GET 'https://api.sibipro.com/product-categories' \
  -H 'Authorization: Bearer YOUR_TOKEN' \
  -H 'Accept: application/json'

const response = await fetch("https://api.sibipro.com/product-categories", {
  method: "GET",
  headers: {
    "Authorization": "Bearer YOUR_TOKEN",
    "Accept": "application/json"
  }
});

Response

{
  "items": [
    {
      "name": "string",
      "suppliers": [
        "ge",
        "msi"
      ]
    }
  ],
  "next": "string"
}

{
  "code": "VALIDATION_ERROR",
  "message": "Invalid input parameters",
  "details": [
    {
      "field": "string",
      "error": "string"
    }
  ],
  "requestId": "string"
}

{
  "code": "UNAUTHORIZED",
  "message": "string",
  "requestId": "string"
}

{
  "code": "REST_TOKEN_REQUIRED",
  "message": "string",
  "requestId": "string"
}

{
  "code": "INTERNAL_SERVER_ERROR",
  "message": "string",
  "requestId": "string"
}