Skip to main content
GET
/
v1
/
decision-categories
List decision categories
curl --request GET \
  --url https://staging.api.us.aptlydone.com/settings/v1/decision-categories \
  --header 'Authorization: Bearer <token>'
{
  "statusCode": 200,
  "timestamp": "2025-06-24T08:51:42.455Z",
  "message": "Success",
  "data": {
    "page": 1,
    "limit": 10,
    "total": 100,
    "data": [
      {
        "id": "4018092c-7bbb-4d44-a72d-f55793ef9b10",
        "tenantId": "3a638310-62ca-454c-8e92-1b18d8d41cf5",
        "sectionId": "f3b80983-4b72-4802-aad1-2d563bf55383",
        "categoryName": "Finance",
        "isDeleted": false,
        "section": {
          "id": "e1b4ddea-2a24-4473-8df0-21527950ad54",
          "tenantId": "00e8f11f-deab-44d2-aee5-f1c0a33c195f",
          "sectionName": "Finance Department",
          "isDeleted": false
        },
        "createdAt": "2024-01-15T12:00:00Z"
      }
    ]
  }
}

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Query Parameters

​
page
number

Page number

Required range: x >= 1
Example:

1

​
limit
number

Number of items per page

Required range: 1 <= x <= 100
Example:

10

​
tenantId
string
required

Tenant ID

Example:

"1c3aa76d-3bd9-438d-b665-065122187f78"

​
sectionIds
string

Section IDs (comma separated)

Example:

"95c83c15-fb94-42ab-8245-aa7c52f763af, a79917f2-047e-4446-ba9b-5dbf6d0f33ad"

​
categoryIds
string

Category IDs (comma separated)

Example:

"a9348bbb-2456-451f-8a4a-a2cc52a04d5e, 05108c61-95c6-449c-bd0b-0e365773705d"

​
search
string

Search

Example:

"Finance"

​
sortBy
string

Field to sort by

Example:

"id"

​
sortOrder
enum<string>
default:asc

Sort order (asc/desc)

Available options:
asc,
desc
Example:

"asc"

Response

200 - application/json

Decision categories list retrieved successfully

​
statusCode
number
required
Example:

200

​
timestamp
string
required
Example:

"2025-06-24T08:51:42.455Z"

​
message
string
required
Example:

"Success"

​
data
object