> ## Documentation Index > Fetch the complete documentation index at: https://developer.findity.com/llms.txt > Use this file to discover all available pages before exploring further. # List approvers of an approval section > 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`. ## OpenAPI ````yaml /openapi/findity-admin-api.json get /organizations/{organizationId}/approval/sections/{sectionId}/approvers openapi: 3.1.0 info: title: Findity Admin API description: Findity Admin API version: 1.0.0 servers: - url: https://stage-api.findity.com/api/v1/admin - url: https://api.findity.com/api/v1/admin security: - bearerAuth: [] paths: /organizations/{organizationId}/approval/sections/{sectionId}/approvers: get: tags: - Approval summary: List approvers of an approval section description: > 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`. operationId: adminListApprovalSectionApprovers parameters: - $ref: '#/components/parameters/organizationIdOrExternalIdInPath' - $ref: '#/components/parameters/sectionIdPath' - name: include in: query required: false description: > 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. schema: type: string enum: - approver.meta.abbreviation example: approver.meta.abbreviation - name: sort in: query required: false description: > 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. schema: type: string default: name:asc,nodeDepth:asc example: nodeDepth:asc,name:asc - $ref: '#/components/parameters/max' - $ref: '#/components/parameters/offset' - $ref: '#/components/parameters/searchText' responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/ApprovalSectionSetup' examples: Approval section approvers - DEPARTMENT type: value: meta: total: 5 count: 5 numberOfApproverLevels: 2 data: - id: 1528b743a5c44eb5963b6dd53a98c43b externalId: null nodeDepth: 0 name: New company displayName: New company parentOrganizationalUnitId: null approvers: [] - id: f21e3a195d2d4744945ac73c0da95fc7 externalId: null parentOrganizationalUnitId: 1528b743a5c44eb5963b6dd53a98c43b nodeDepth: 1 name: Unit 1 displayName: '-Unit 1' approvers: - id: 6a1f0b3a2f684c7c9a8901a2b3c4d5e6 personId: ff8080819e74371c019e7437518600fa personExternalId: null firstName: FirstName1 lastName: LastName1 email: firstName1.lastName1@test.com level: 0 amountLimit: null - id: 6a1f0b3a2f684c7c9a8901a2b3c4d5e7 personId: ff8080819e74371c019e7437519f00fe personExternalId: null firstName: FirstName2 lastName: LastName2 email: firstName2.lastName2@test.com level: 0 amountLimit: null - id: 18fdb1a0b9564f34992a48937b639fec externalId: null parentOrganizationalUnitId: 1528b743a5c44eb5963b6dd53a98c43b nodeDepth: 1 name: Unit 2 displayName: '-Unit 2' approvers: - id: 6a1f0b3a2f684c7c9a8901a2b3c4d5e8 personId: ff8080819e74371c019e743751ba0102 personExternalId: null firstName: FirstName3 lastName: LastName3 email: firstName3.lastName3@test.com level: 0 amountLimit: null meta: fullName: FirstName3 LastName3 fullNameWithEmail: >- FirstName3 LastName3 (firstName3.lastName3@test.com) amountLimitDescription: null - id: 6a1f0b3a2f684c7c9a8901a2b3c4d5e9 personId: ff8080819e74371c019e743751d20106 personExternalId: null firstName: FirstName4 lastName: LastName4 email: firstName4.lastName4@test.com level: 1 amountLimit: null meta: fullName: FirstName4 LastName4 fullNameWithEmail: >- FirstName4 LastName4 (firstName4.lastName4@test.com) amountLimitDescription: null - id: 6a1f0b3a2f684c7c9a8901a2b3c4d5ea personId: ff8080819e74371c019e743751e8010a personExternalId: null firstName: FirstName1 lastName: LastName1 email: firstName1.lastName1@test.com level: 1 amountLimit: 200.1 meta: fullName: FirstName1 LastName1 fullNameWithEmail: >- FirstName1 LastName1 (firstName1.lastName1@test.com) amountLimitDescription: 200,10 SEK - id: 005613bdcf5b4e17ba1cc44edef18df6 externalId: 95b24a86298348b6b1a11ee1cd68e01a parentOrganizationalUnitId: 1528b743a5c44eb5963b6dd53a98c43b nodeDepth: 1 name: Unit 3 displayName: '-Unit 3' approvers: [] - id: beba831d89c44c81a647e9e60bdd8fad externalId: 48b4815706c447a1bbf2331c876e4448 parentOrganizationalUnitId: 005613bdcf5b4e17ba1cc44edef18df6 nodeDepth: 2 name: Unit 3.1 displayName: '--Unit 3.1' approvers: [] Approval section approvers - DIMENSION type: value: meta: total: 3 count: 3 numberOfApproverLevels: 2 data: - id: cef8f8f9d3af4d6cbe9e0d90c9d9c001 externalId: null name: DimensionListValue 1 displayName: DimensionListValue 1 approvers: - id: 6a1f0b3a2f684c7c9a8901a2b3c4d5f0 personId: 8ab28c4f6f1da520016f2377703c01a7 personExternalId: null email: firstName1.lastName1@test.com firstName: FirstName1 lastName: LastName1 level: 0 amountLimit: null meta: fullName: FirstName1 LastName1 fullNameWithEmail: >- FirstName1 LastName1 (firstName1.lastName1@test.com) amountLimitDescription: null - id: 6a1f0b3a2f684c7c9a8901a2b3c4d5f1 personId: f21e3a195d2d4744945ac73c0da95fc7 personExternalId: null email: firstName3.lastName3@test.com firstName: FirstName3 lastName: LastName3 level: 0 amountLimit: 250.1 meta: fullName: FirstName3 LastName3 fullNameWithEmail: >- FirstName3 LastName3 (firstName3.lastName3@test.com) amountLimitDescription: 250,10 SEK - id: 6a1f0b3a2f684c7c9a8901a2b3c4d5f2 personId: 8a5c9c29938ca0fa01938cac4a13009a personExternalId: null email: firstName2.lastName2@test.com firstName: FirstName2 lastName: LastName2 level: 1 amountLimit: null meta: fullName: FirstName2 LastName2 fullNameWithEmail: >- FirstName2 LastName2 (firstName2.lastName2@test.com) amountLimitDescription: null - id: cef8f8f9d3af4d6cbe9e0d90c9d9c002 externalId: null name: DimensionListValue 2 displayName: DimensionListValue 2 approvers: [] - id: cef8f8f9d3af4d6cbe9e0d90c9d9c003 externalId: null name: DimensionListValue 3 displayName: DimensionListValue 3 approvers: [] '400': description: Bad request content: application/json: schema: $ref: '#/components/schemas/400Error' examples: Dimension has an invalid control type for approval: value: result: error code: INVALID_DIMENSION_CONTROL_TYPE_FOR_APPROVAL description: >- Dimension is not defined with controlType=LIST or controlType=LIST_SEARCHABLE to be used in approval flow '404': description: Not found error content: application/json: schema: $ref: '#/components/schemas/404Error' examples: Organization not found: value: result: error code: ORGANIZATION_NOT_FOUND description: Organization not found No active license found for approval for organization: value: result: error code: LICENSE_APPROVAL_NOT_FOUND description: Active license for approval flow not found Approval section not found: value: result: error code: APPROVAL_SECTION_NOT_FOUND description: Section with id {sectionId} is not found components: parameters: organizationIdOrExternalIdInPath: in: path name: organizationId required: true description: >- 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 schema: type: string examples: Findity unique id: value: 05b8daba9ba14a49846fe77883248cf0 External system unique id: value: a31a7372-3397-3924-ffcd-b7b4795e42eb sectionIdPath: in: path name: sectionId required: true description: >- Unique identifier of the approval section. String in UUID without dashes (32-character hex string). schema: $ref: '#/components/schemas/Uuid' example: abcdd5f401cf43549a688045b5ceef9b max: name: max in: query description: max records to return required: false schema: type: integer format: int minimum: 1 maximum: 1000 default: 10 offset: name: offset in: query description: the offset to be used in list required: false schema: type: integer format: int minimum: 0 default: 0 searchText: name: searchText in: query description: free text to search for required: false schema: type: string schemas: ApprovalSectionSetup: type: object description: >- Paginated list of approval section items (organizational units or custom dimension values) with their approval configuration for the requested section. properties: meta: type: object readOnly: true description: Pagination and approval-level metadata for the response. required: - count - total - numberOfApproverLevels properties: count: type: integer description: Number of items returned in the data array for this page. minimum: 0 total: type: integer description: >- Total number of matching approval section items. May exceed count when pagination is applied. minimum: 0 numberOfApproverLevels: type: integer description: >- Maximum number of approver levels found across all items in the response. Useful for rendering approval-level columns in a UI. 0 when no approvers are configured. minimum: 0 data: type: array description: >- Array of approval section items (organizational units or custom dimension values) belonging to this approval section. items: type: object required: - id - approvers properties: id: allOf: - $ref: '#/components/schemas/Uuid' readOnly: true description: >- Findity identifier of the approval section item (organizational unit external id, or custom dimension list value id). externalId: type: string description: >- External source identifier of the approval section item as provided by the integrating system. Null if not set. maxLength: 255 nullable: true name: type: string description: Name of the approval section item. maxLength: 255 displayName: type: string description: > Display-formatted name with leading dashes representing the node's depth in the organizational hierarchy. For example, "--Backend" for a node at depth 2. Equals name when nodeDepth is 0 or null. maxLength: 255 nullable: true parentOrganizationalUnitId: type: string pattern: ^[0-9a-fA-F]{32}$ description: >- UUID (without dashes) of the parent organizational unit. Null if this unit is a root node with no parent. Only populated when the section type is DEPARTMENT. maxLength: 32 nullable: true nodeDepth: type: integer description: >- Depth of this organizational unit in the hierarchy. 0 indicates a root node. Null if depth information is unavailable. Only populated when the section type is DEPARTMENT. minimum: 0 nullable: true approvers: type: array description: >- Flat list of approvers configured for this approval section item across all levels. Empty array if no approvers have been assigned. items: $ref: '#/components/schemas/Approver' 400Error: type: object properties: result: type: string code: type: string description: type: string 404Error: type: object properties: result: type: string code: type: string description: type: string example: result: error code: ORGANIZATION_NOT_FOUND description: 'Failed to get organization for id: {orgId}' Uuid: type: string pattern: ^[0-9a-fA-F]{32}$ description: UUID without dashes (32-character hex string) Approver: type: object description: An approver assigned to an approval section item at a specific level. required: - id - level - personId properties: id: allOf: - $ref: '#/components/schemas/Uuid' readOnly: true description: >- Findity unique identifier of the approver record (not the person). Use this value when updating or deleting the approver. personId: allOf: - $ref: '#/components/schemas/Uuid' description: Findity identifier of the person acting as approver. personExternalId: type: string description: >- External source identifier of the person as provided by the integrating system. Null if not set. maxLength: 255 nullable: true firstName: type: string description: First name of the approver. maxLength: 255 lastName: type: string description: Last name of the approver. maxLength: 255 email: type: string format: email description: Email address of the approver. maxLength: 255 level: type: integer description: >- Sequential approval level of this approver within the section item. Approvers are processed from lowest to highest level. minimum: 0 amountLimit: type: number format: double description: >- Maximum expense report amount this approver is authorized to approve, expressed in the organization's base currency. Null indicates no upper limit applies. nullable: true minimum: 0 meta: type: object description: > Display metadata for the approver. Present only on GET responses when the request includes the query parameter `include=approver.meta.abbreviation`. Never returned on POST/PUT responses. required: - fullName - fullNameWithEmail properties: fullName: type: string description: Full name of the approver, formatted as "firstName lastName". maxLength: 511 fullNameWithEmail: type: string description: >- Full name with email address, formatted as "firstName lastName (email@example.com)". maxLength: 511 amountLimitDescription: type: string description: > Localized, currency-formatted representation of the approver's amountLimit using the organization's base currency (e.g. "200,10 SEK"). Null when amountLimit is null. nullable: true maxLength: 64 securitySchemes: bearerAuth: type: http scheme: bearer ````