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/

Authorization

AuthorizationBearer token · headerrequired

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

Scopes:read:product-categories

Query parameters

firstinteger

max 100 · default: 10

supplierstring | string[]

afterstring

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

Invalid input parameters (VALIDATION_ERROR), or after is not a cursor this endpoint issued (INVALID_CURSOR)

Any of:

ValidationErrorResponse

codestringrequired

Allowed:VALIDATION_ERROR

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

Missing Authorization header.

messagestringrequired

403

The bearer token could not be resolved (invalid, expired, or revoked), it 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)

Any of:

object

messagestringrequired

object

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"

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

Response

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

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

{
  "message": "Unauthorized"
}

{
  "message": "Forbidden"
}

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