GET
/
v1
/
delegations
List delegations
curl --request GET \
  --url https://staging.api.us.aptlydone.com/decision/v1/delegations \
  --header 'Authorization: Bearer <token>'
{
  "statusCode": 200,
  "timestamp": "2025-06-24T10:47:33.417Z",
  "message": "Success",
  "data": {
    "page": 1,
    "limit": 10,
    "total": 100,
    "data": [
      {
        "id": "9f45f94d-20d2-4163-85d9-68f4f699e440",
        "tenantId": "105fa115-52d0-4466-baff-740447a60774",
        "status": "DRAFT",
        "isRootDelegation": false,
        "issuerType": "ROOT_AUTHORITY",
        "issuerUserId": "648fa115-52d0-4466-baff-740447a60774",
        "issuerPositionId": "257fa115-52d0-4466-baff-740447a60774",
        "recipientType": "PERSONNEL_IN_POSITION",
        "recipientAutoIssue": false,
        "decisionId": "864fa115-52d0-4466-baff-740447a60774",
        "parentDelegationId": "726fa115-52d0-4466-baff-740447a60774",
        "issuedDate": "2025-01-01T12:00:00Z",
        "expirationDate": "2025-12-31T12:00:00Z",
        "isNoExpiration": false,
        "effectiveDate": "2025-01-01T12:00:00Z",
        "copiedFrom": "7df90da4-0634-40b9-abf5-6e97a222cfb8",
        "delegationPathway": [],
        "delegationRecipients": [],
        "delegationGroups": [],
        "delegationAuthorities": [],
        "delegationDocuments": [],
        "delegationDisplayId": "12789",
        "link": "/delegations/view/eyJ0ZW5hbnRJZCI6IjEwNWZhMTE1LTUyZDAtNDQ2Ni1iYWZmLTc0MDQ0N2E2MDc3NCIsImRlbGVnYXRpb25JZCI6IjMwOGNiMzMxLWYwMTgtNGJjNS1hMWE3LTQ1MTI4NTU4MTg0MyJ9",
        "delegationId": "9f45f94d-20d2-4163-85d9-68f4f699e440",
        "sourceDecision": {
          "id": "7df90da4-0634-40b9-abf5-6e97a222cfb8",
          "decisionDisplayId": "14623",
          "name": "Long-term Investments",
          "description": "The Long-term Investments authority involves approving strategic investments",
          "guidance": "Investment decisions for long-term, strategic investments...",
          "sectionId": "105fa115-52d0-4466-baff-740447a60774",
          "categoryId": "248fa115-52d0-4466-baff-740447a60774"
        },
        "isInvalid": false,
        "invalidFields": [
          "delegationGroups",
          "delegationAuthorities"
        ],
        "actionIssuerApproval": true,
        "actionDelegationAcceptance": true,
        "actionAuthorityRequest": true,
        "approvalActionExistForUser": true,
        "acceptanceActionExistForUser": 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"

​
status
enum<string>[]

Comma separated Delegation Status values

​
search
string

Delegation search string

Example:

""

​
section
string[]

Comma separated Section IDs

Example:

null

​
category
string[]

Comma separated Category IDs

Example:

null

​
sortBy
enum<string>

Criteria for sorting Delegations

Available options:
delegationDisplayId,
decisionName,
sectionName,
categoryName,
status,
updatedAt,
expirationDate,
authorityLimitSortPrecedence,
rank
​
sortOrder
enum<string>

Order for sorting Delegations

Available options:
asc,
desc
​
groupIds
string[]

Comma separated Group IDs

Example:

null

​
positionIds
string[]

Comma separated Position IDs

Example:

null

​
redelegable
boolean

Redelegable filter

Example:

true

​
isInvalid
boolean

Invalid delegations filter (Delegations with alerts)

Example:

true

​
authorityTypeIds
string[]

Comma separated Authority Type IDs

Example:

null

​
authorityLimitValueTypes
enum<string>[]

Comma separated Authority Value Types

​
authorityLimitValueFilters
object[]

Authority Limit Value Filters

​
select
enum<string>[]

Comma separated specific Delegation fields needed in response

​
fetchOnlyOwnDelegations
boolean

If true, only returns delegations for which current user is issuer/recipient

Example:

true

​
issuerType
object

Delegation issuer type

​
issuerUserId
string

Delegation issuer user id

Example:

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

​
issuerPositionId
string

Delegation issuer position id

Example:

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

​
roles
string[]

Comma separated Role IDs

Example:

null

​
conditions
boolean

Conditions filter

Example:

true

​
issuedStartDate
string

Start date time for date range filter on delegation issued date

Example:

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

​
issuedEndDate
string

End date time for date range filter on delegation issued date

Example:

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

​
acceptedStartDate
string

Start date time for date range filter on delegation accepted date

Example:

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

​
acceptedEndDate
string

End date time for date range filter on delegation accepted date

Example:

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

​
expiredStartDate
string

Start date time for date range filter on delegation expired date

Example:

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

​
expiredEndDate
string

End date time for date range filter on delegation expired date

Example:

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

​
issuers
object

Issuers Filters

​
recipients
object

Recipients Filters

​
decisions
string[]

Comma separated Decision IDs

Example:

null

​
isRootDelegation
boolean

Root Delegation filter

Example:

true

​
invalidFields
string[]

Comma separated Delegation Invalid Fields

Response

200 - application/json

Delegations list retrieved successfully

The response is of type object.