List approvers of an approval section

get

https://stage-api.findity.com/api/v1/admin/organizations/{organizationId}/approval/sections/{sectionId}/approvers

Returns the approval section items (organizational units for DEPARTMENT sections, custom dimension values for DIMENSION sections) together with the approvers configured on each item. The organizationId path parameter supports both the Findity id and the partner-side externalId.

Path Params

organizationId

string

required

Unique identifier of the organization. String in UUID without dashes (32-character hex string) if access is done via values from Findity system otherwise, id of external system can be used

sectionId

string

required

^[0-9a-fA-F]{32}$

Unique identifier of the approval section. String in UUID without dashes (32-character hex string).

Query Params

include

string

enum

Comma-separated list of extra fields to include in the response. Currently supported value: approver.meta.abbreviation — when provided, adds a meta object to each approver containing fullName, fullNameWithEmail, and amountLimitDescription formatted using the organization's base currency.

Allowed:

sort

string

Defaults to name:asc,nodeDepth:asc

Comma-separated list of properties to sort by, each followed by a colon and a direction (asc or desc). Available sort properties: nodeDepth (only for DEPARTMENT sections), name, externalId, id.

max

integer

1 to 1000

Defaults to 10

max records to return

offset

integer

≥ 0

Defaults to 0

the offset to be used in list

searchText

string

free text to search for

Responses

Language

Credentials

Bearer

URL

Loading…

Response

Click Try It! to start a request and see the response here! Or choose an example:

application/json

200OK

400Bad request

404Not found error