List decisions

GET /v1/decisions

List decisions

cURL

curl --request GET \
  --url https://staging.api.us.aptlydone.com/decision/v1/decisions \
  --header 'Authorization: Bearer <token>'

200

{
  "statusCode": 200,
  "timestamp": "2026-01-08T06:33:50.975Z",
  "message": "Success",
  "data": {
    "page": 1,
    "limit": 10,
    "total": 100,
    "data": [
      {
        "id": "7df90da4-0634-40b9-abf5-6e97a222cfb8",
        "tenantId": "105fa115-52d0-4466-baff-740447a60774",
        "name": "Long-term Investments",
        "description": "The Long-term Investments authority involves approving strategic investments, including equity stakes, acquisitions, and other business ventures.",
        "guidance": "Investment decisions for long-term, strategic investments, such as acquisitions and equity stakes, require a structured process that ensures alignment with corporate strategy, rigorous financial analysis, risk assessment, and strong governance. These investments should enhance the company's competitive positioning, growth potential, and long-term vision. Financial modeling is critical, incorporating valuation methods, cash flow impacts, and sensitivity analysis to forecast returns under different scenarios.",
        "sectionId": "105fa115-52d0-4466-baff-740447a60774",
        "categoryId": "105fa115-52d0-4466-baff-740447a60774",
        "status": "PUBLISHED",
        "createdBy": null,
        "owner": null,
        "createdAt": "2024-12-18T09:50:43.338Z",
        "updatedBy": null,
        "updatedAt": "2024-12-18T09:50:43.338Z",
        "copiedFrom": null,
        "conditionEnabled": false,
        "roleEnabled": false,
        "delegable": true,
        "decisionDisplayId": "14623",
        "delegationPathway": [
          "Matrix",
          "Direct Line",
          "Functional"
        ],
        "link": "/decisions/view/eyJ0ZW5hbnRJZCI6MSwiZGVjaXNpb25JZCI6ImU4YTEzYmQ0LTExYzItNDNkMi1hM2RjLWUxOGQ2ODU1NTU4OCJ9",
        "decisionId": "7df90da4-0634-40b9-abf5-6e97a222cfb8",
        "sectionName": "Financial Authority",
        "categoryName": "Budget Approval",
        "createdByUsername": "John Doe",
        "ownerUsername": "John Doe",
        "updatedByUsername": null,
        "decisionGroups": [
          {
            "id": "7df90da4-0634-40b9-abf5-6e97a222cfb8",
            "denormalizedDecisionId": "7df90da4-0634-40b9-abf5-6e97a222cfb8",
            "groupId": "105fa115-52d0-4466-baff-740447a60774",
            "tenantGroupTypeId": "105fa115-52d0-4466-baff-740447a60774",
            "displayName": "Engineering Team",
            "groupName": "Engineering Team"
          }
        ],
        "decisionAuthorities": [
          {
            "id": "7df90da4-0634-40b9-abf5-6e97a222cfb8",
            "denormalizedDecisionId": "7df90da4-0634-40b9-abf5-6e97a222cfb8",
            "authorityTypeId": "105fa115-52d0-4466-baff-740447a60774",
            "authorityType": "Approval",
            "authorityTypeOrder": 1,
            "authorityTypeIcon": "check-square",
            "authorityLimit": "Primary",
            "authorityLimitValueType": "Currency",
            "authorityLimitOperator": "<",
            "authorityLimitValue": "1000",
            "authorityLimitValueUnit": "$"
          }
        ],
        "decisionDocuments": [
          {
            "id": "7df90da4-0634-40b9-abf5-6e97a222cfb8",
            "denormalizedDecisionId": "7df90da4-0634-40b9-abf5-6e97a222cfb8",
            "documentId": "105fa115-52d0-4466-baff-740447a60774",
            "documentName": "Proxy Comm Delegation of Authority Policy",
            "documentUrl": "https://filesamples.com/samples/document/pdf/sample1.pdf",
            "documentTypeName": "Policy",
            "documentIcon": "file_text_outlined",
            "documentDescription": "Defines the framework for delegating authority across ProxyComm's global operations, outlining roles, responsibilities, and decision-making limits to ensure compliance, accountability, and operational consistency.",
            "documentFileType": "pdf",
            "isPinned": true,
            "documentDisplayId": "10000",
            "documentStatus": "PUBLISHED",
            "documentFileLink": "https://example.com/files/project_document.pdf"
          }
        ],
        "delegations": 0,
        "ownerUserProfileUrl": "http://test.jpg",
        "createdByUserProfileUrl": "http://test.jpg",
        "updatedByUserProfileUrl": "http://test.jpg",
        "permissions": [
          {
            "relationship_key": "<string>",
            "allowed": true
          }
        ],
        "createdByDetails": {},
        "updatedByDetails": {},
        "ownerDetails": {},
        "isRequestActionCompleted": true
      }
    ]
  }
}

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:

"105fa115-52d0-4466-baff-740447a60774"

ids · string[]

Comma separated Decision IDs

Example:

null

status · enum<string>[]

Comma separated Decision Status values

Available options: DRAFT, PUBLISHED, ARCHIVED, DELETED

search · string

Decision search string

Example:

"Investmen"

section · string[]

Comma separated Section IDs

Example:

null

category · string[]

Comma separated Category IDs

Example:

null

sortBy · enum<string>

Criteria for sorting Decisions

Available options: name, sectionName, categoryName, status, updatedAt, createdAt, delegationsCount, authorityLimitSortPrecedence, decisionDisplayId, rank

sortOrder · enum<string>

Order for sorting Decisions

Available options: asc, desc

groupIds · string[]

Comma separated Group IDs

Example:

null

delegable · boolean

Delegable filter

Example:

true

delegations · boolean

Delegations filter

Example:

true

authorityTypeIds · string[]

Comma separated Authority Type IDs

Example:

null

authorityLimitValueTypes · enum<string>[]

Comma separated Decision Authority Value Types

Available options: Currency, Number, Days, Months, Years, Authorized, Percentage

authorityLimitValueFilters · object[]

Authority Limit Value Filters

Show child attributes

select · enum<string>[]

Comma separated specific Decision fields needed in response

Available options: DECISION_ID, NAME, DECISION_DISPLAY_ID, DESCRIPTION, GUIDANCE, SECTION_ID, SECTION_NAME, CATEGORY_ID, CATEGORY_NAME, STATUS, PREVIOUS_STATUS, CREATED_BY, CREATED_BY_USERNAME, UPDATED_BY, UPDATED_BY_USERNAME, CREATED_AT, UPDATED_AT, OWNER, OWNER_USERNAME, COPIED_FROM, CONDITION_ENABLED, ROLE_ENABLED, DELEGABLE, DELEGATION_PATHWAY, LINK, DELEGATIONS_COUNT, AUTHORITY_LIMIT_SORT_PRECEDENCE, DECISION_AUTHORITIES, DECISION_GROUPS, DECISION_DOCUMENTS

issuerType · object

Delegation issuer type

owner · string[]

Comma separated User IDs for Owner filter

Example:

null

createdStartDate · string

Start date time for date range filter on decision created at

Example:

"2025-03-05T11:49:50.577Z"

createdEndDate · string

End date time for date range filter on decision created at

Example:

"2025-03-05T11:49:50.577Z"

updatedStartDate · string

Start date time for date range filter on decision updated at

Example:

"2025-03-05T11:49:50.577Z"

updatedEndDate · string

End date time for date range filter on decision updated at

Example:

"2025-03-05T11:49:50.577Z"

Response

200 - application/json

Decisions list retrieved successfully

statusCode · number · required

Example:

200

timestamp · string · required

Example:

"2026-01-08T06:33:50.975Z"

message · string · required

Example:

"Success"

data · object

Show child attributes