Get a list of Departments

GET

/v2/departments/list

Query existing departments that are associated with products at the show

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

Bodyapplication/json

🟠400Bad Request

Request Example

Shell

JavaScript

Java

Swift

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

Response Example

200 - Departments

{
    "pagination": {
        "totalRecords": 2,
        "page": 1,
        "resultsPerPage": 20
    },
    "items": [
        {
            "id": "k3m9qz",
            "departmentID": "FRZ",
            "departmentDescription": "Frozen"
        },
        {
            "id": "w7p2xd",
            "departmentID": "DRY",
            "departmentDescription": "Dry Grocery"
        }
    ]
}

Modified at 2026-10-16 13:14:22

Delete a Category

Retrieve a specific Department by ID