Search delegations

POST /v1/delegations/global-search

Search delegations

cURL

curl --request POST \
  --url https://staging.api.us.aptlydone.com/decision/v1/delegations/global-search \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "tenantId": "105fa115-52d0-4466-baff-740447a60774",
  "page": 1,
  "limit": 10,
  "status": "ISSUED",
  "search": "Authority Wisdom",
  "section": null,
  "category": null,
  "groupIds": null,
  "positionIds": null,
  "redelegable": true,
  "isInvalid": true,
  "authorityTypeIds": null,
  "authorityLimitValueTypes": "Days,Months,Years",
  "authorityLimitValueFilters": [
    {
      "authorityLimitValueType": "Years",
      "minValue": "1",
      "maxValue": "Unlimited"
    }
  ],
  "roles": null,
  "conditions": true,
  "issuedStartDate": "2025-03-05T11:49:50.577Z",
  "issuedEndDate": "2025-03-05T11:49:50.577Z",
  "updatedStartDate": "2025-03-05T11:49:50.577Z",
  "updatedEndDate": "2025-03-05T11:49:50.577Z",
  "effectiveStartDate": "2025-03-05T11:49:50.577Z",
  "effectiveEndDate": "2025-03-05T11:49:50.577Z",
  "acceptedStartDate": "2025-03-05T11:49:50.577Z",
  "acceptedEndDate": "2025-03-05T11:49:50.577Z",
  "expiredStartDate": "2025-03-05T11:49:50.577Z",
  "expiredEndDate": "2025-03-05T11:49:50.577Z",
  "issuers": {
    "personnelInPosition": null,
    "positionOnly": null,
    "specificPersonnel": null
  },
  "recipients": {
    "personnelInPosition": null,
    "positionOnly": null,
    "specificPersonnel": null
  },
  "decisions": null,
  "isRootDelegation": true,
  "invalidFields": "delegationIssuer,delegationGroups,delegationPathway",
  "issuerTypes": "PERSONNEL_IN_POSITION,POSITION_ONLY,SPECIFIC_PERSONNEL,ROOT_AUTHORITY",
  "recipientTypes": "PERSONNEL_IN_POSITION,POSITION_ONLY,SPECIFIC_PERSONNEL",
  "userIds": null,
  "startDate": "2025-03-05T11:49:50.577Z",
  "endDate": "2025-03-05T11:49:50.577Z",
  "selectedTab": "active",
  "sortBy": "delegationDisplayId",
  "sortOrder": "asc",
  "select": "DELEGATION_ID,DELEGATION_DISPLAY_ID,SOURCE_DECISION",
  "fetchOnlyOwnDelegations": true,
  "issuerType": "ROOT_AUTHORITY",
  "issuerUserId": "648fa115-52d0-4466-baff-740447a60774",
  "issuerPositionId": "257fa115-52d0-4466-baff-740447a60774"
}
'

200

{
  "statusCode": 200,
  "timestamp": "2026-01-08T06:33:50.693Z",
  "message": "Success",
  "data": {
    "page": 1,
    "limit": 10,
    "total": 100,
    "data": [
      {
        "id": "9f45f94d-20d2-4163-85d9-68f4f699e440",
        "tenantId": "105fa115-52d0-4466-baff-740447a60774",
        "issuerType": "ROOT_AUTHORITY",
        "recipientType": "PERSONNEL_IN_POSITION",
        "decisionId": "864fa115-52d0-4466-baff-740447a60774",
        "issuedDate": "2025-01-01T12:00:00Z",
        "acceptedDate": "2025-01-01T12:00:00Z",
        "effectiveDate": "2025-01-01T12:00:00Z",
        "delegationDisplayId": "12789",
        "link": "/delegations/view/eyJ0ZW5hbnRJZCI6IjEwNWZhMTE1LTUyZDAtNDQ2Ni1iYWZmLTc0MDQ0N2E2MDc3NCIsImRlbGVnYXRpb25JZCI6IjMwOGNiMzMxLWYwMTgtNGJjNS1hMWE3LTQ1MTI4NTU4MTg0MyJ9",
        "status": "DRAFT",
        "isRootDelegation": false,
        "issuerUserId": "648fa115-52d0-4466-baff-740447a60774",
        "issuerPositionId": "257fa115-52d0-4466-baff-740447a60774",
        "recipientAutoIssue": false,
        "parentDelegationId": "726fa115-52d0-4466-baff-740447a60774",
        "expirationDate": "2025-12-31T12:00:00Z",
        "isNoExpiration": false,
        "updatedAt": "2025-01-01T12:00:00Z",
        "copiedFrom": "7df90da4-0634-40b9-abf5-6e97a222cfb8",
        "delegationPathway": [],
        "delegationRecipients": [],
        "delegationGroups": [],
        "delegationAuthorities": [],
        "delegationDocuments": [],
        "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.

Body

application/json

tenantId · string · required

Tenant ID

Example:

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

page · number

Page number

Required range: x >= 1

Example:

1

limit · number

Number of items per page

Required range: 1 <= x <= 100

Example:

10

status · object[]

Comma separated Delegation Status values

Example:

"ISSUED"

search · string

Delegation search string

Example:

"Authority Wisdom"

section · string[]

Comma separated Section IDs

Example:

null

category · string[]

Comma separated Category IDs

Example:

null

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 · string[]

Comma separated Authority Value Types

Example:

"Days,Months,Years"

authorityLimitValueFilters · object[]

Authority Limit Value Filters

Show child attributes

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"

updatedStartDate · string

Start date time for date range filter on delegation updated date

Example:

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

updatedEndDate · string

End date time for date range filter on delegation updated date

Example:

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

effectiveStartDate · string

Start date time for date range filter on delegation effective date

Example:

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

effectiveEndDate · string

End date time for date range filter on delegation effective 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

Show child attributes

recipients · object

Recipients Filters

Show child attributes

decisions · string[]

Comma separated Decision IDs

Example:

null

isRootDelegation · boolean

Root Delegation filter

Example:

true

invalidFields · string[]

Comma separated Delegation Invalid Fields

Example:

"delegationIssuer,delegationGroups,delegationPathway"

issuerTypes · object[]

Comma separated Delegation issuer types values

Example:

"PERSONNEL_IN_POSITION,POSITION_ONLY,SPECIFIC_PERSONNEL,ROOT_AUTHORITY"

recipientTypes · object[]

Comma separated Delegation recipient types values

Example:

"PERSONNEL_IN_POSITION,POSITION_ONLY,SPECIFIC_PERSONNEL"

userIds · string[]

Comma separated User IDs

Example:

null

startDate · string

Creation/updation date time for delegation

Example:

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

endDate · string

Creation/updation date time for delegation

Example:

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

selectedTab · enum<string>

Selected tab context (not used in the listing API)

Available options: active, inactive, mine, suspended, pending, all

Example:

"active"

sortBy · enum<string>

Criteria for sorting Delegations

Available options: delegationDisplayId, decisionName, sectionName, categoryName, status, updatedAt, expirationDate, authorityLimitSortPrecedence, rank, issuedDate, effectiveDate, acceptedDate, createdAt

Example:

"delegationDisplayId"

sortOrder · enum<string>

Order for sorting Delegations

Available options: asc, desc

Example:

"asc"

select · string[]

Comma separated specific Delegation fields needed in response

Example:

"DELEGATION_ID,DELEGATION_DISPLAY_ID,SOURCE_DECISION"

fetchOnlyOwnDelegations · boolean

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

Example:

true

issuerType · object

Delegation issuer type

Example:

"ROOT_AUTHORITY"

issuerUserId · string

Delegation issuer user id

Example:

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

issuerPositionId · string

Delegation issuer position id

Example:

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

Response

200

application/json

Delegations list retrieved successfully

statusCode · number · required

Example:

200

timestamp · string · required

Example:

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

message · string · required

Example:

"Success"

data · object

Show child attributes