GET
/
v1
/
decisions
List decisions
curl --request GET \
  --url https://staging.api.us.aptlydone.com/decision/v1/decisions \
  --header 'Authorization: Bearer <token>'
{
  "statusCode": 200,
  "timestamp": "2025-06-24T10:47:33.138Z",
  "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,
        "delegations": 0,
        "decisionGroups": [
          {
            "id": "7df90da4-0634-40b9-abf5-6e97a222cfb8",
            "denormalizedDecisionId": "7df90da4-0634-40b9-abf5-6e97a222cfb8",
            "groupId": "105fa115-52d0-4466-baff-740447a60774",
            "groupName": "Engineering Team",
            "tenantGroupTypeId": "105fa115-52d0-4466-baff-740447a60774"
          }
        ],
        "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": "Value (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",
            "documentFileLink": "https://example.com/files/project_document.pdf",
            "isPinned": true,
            "documentDisplayId": "10000",
            "documentStatus": "PUBLISHED"
          }
        ],
        "ownerUserProfileUrl": "http://test.jpg",
        "createdByUserProfileUrl": "http://test.jpg",
        "updatedByUserProfileUrl": "http://test.jpg",
        "permissions": [
          {
            "allowed": true,
            "relationship_key": "<string>"
          }
        ],
        "createdByDetails": {},
        "updatedByDetails": {},
        "ownerDetails": {}
      }
    ]
  }
}

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

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,
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

authorityLimitValueFilters
object[]

Authority Limit Value Filters

select
enum<string>[]

Comma separated specific Decision fields needed in response

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

The response is of type object.