Get a list of Categories

GET

/v2/categories/list

Query existing categories that are associated with products at the sho

Request

Authorization

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Query Params

Responses

🟢200OK

application/json

Body

🟠400Bad Request

Request Example

Shell

JavaScript

Java

Swift

curl --location --request GET 'https://tsapi.perenso.net/v2/categories/list?sort=&modifiedAfter=&page=1&resultsPerPage=20' \
--header 'Authorization: Bearer <token>'

Response Example

200 - Categories

{
    "pagination": {
        "totalRecords": 2,
        "page": 1,
        "resultsPerPage": 20
    },
    "items": [
        {
            "id": "h2gg8a",
            "categoryID": "1943",
            "categoryDescription": "Rubber"
        },
        {
            "id": "33f2g6",
            "categoryID": "4929",
            "categoryDescription": "Metal"
        }
    ]
}

Modified at 2025-10-08 20:26:40

Update a Category

Retrieve a specific Category by ID