> ## 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. # Get approval sections > Returns the approval sections configured on the organization. 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 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: get: tags: - Approval summary: List approval sections description: > Returns the approval sections configured on the organization. The `organizationId` path parameter supports both the Findity id and the partner-side `externalId`. operationId: adminListApprovalSections parameters: - $ref: '#/components/parameters/organizationIdOrExternalIdInPath' - name: active in: query description: >- Boolean filter for approval section status. When `true`, returns only active approval sections; when `false`, returns only inactive sections. If omitted, sections are returned regardless of active status. required: false example: false schema: type: boolean enum: - true - false - name: type in: query description: >- Filter approval sections by type. Accepted values are DEPARTMENT and DIMENSION. required: false example: DEPARTMENT schema: type: string enum: - DEPARTMENT - DIMENSION - name: sort in: query description: > Comma-separated list of properties to sort by, each followed by a colon and a direction (asc or desc). Available sort properties: sortOrder, type, active. required: false example: sortOrder:asc,type:desc schema: type: string default: sortOrder:asc - $ref: '#/components/parameters/max' - $ref: '#/components/parameters/offset' responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/ApprovalSections' examples: Approval sections - empty response: value: data: [] meta: total: 0 count: 0 Approval sections - normal response: value: data: - sendToUnauthorizedApprovers: false sortOrder: 0 active: true id: abcdd5f401cf43549a688045b5ceef9b type: DEPARTMENT numberOfRequiredApprovals: 2 - sendToUnauthorizedApprovers: false sortOrder: 0 active: true id: 66c064b81a734cf2b03ec9cfe1d501d4 type: DIMENSION customDimensionDefinition: name: Approval dimension 0 id: 6c2d8a0c660d45a5b3bef56c7ec1462b numberOfRequiredApprovals: 2 - sendToUnauthorizedApprovers: false sortOrder: 1 active: false id: d81464f9a34a446cad8bb10cff948627 type: DEPARTMENT numberOfRequiredApprovals: 2 - sendToUnauthorizedApprovers: false sortOrder: 1 active: false id: 69f369bb476344209d1a9bbfd1f40773 type: DIMENSION customDimensionDefinition: name: Approval dimension 0 id: 6c2d8a0c660d45a5b3bef56c7ec1462b numberOfRequiredApprovals: 2 meta: total: 4 count: 4 '404': description: Not found error content: application/json: schema: $ref: '#/components/schemas/404Error' examples: Access to approval sections data for organization by user denied: 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 workflow has not been enabled for the organization: value: result: error code: APPROVAL_FLOW_NOT_ENABLED description: Approval workflow must be enabled first Unknown value provided for the type query filter: value: result: error code: APPROVAL_TYPE_NOT_FOUND description: Provided type is an unknown value 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 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 schemas: ApprovalSections: type: object description: Response with a list of approval sections properties: meta: type: object readOnly: true description: Pagination metadata for the response. properties: count: type: integer description: A number of items returned in data node of response total: type: integer description: >- A total number of items found. It is not mandatory that all items need to be delivered in the response. data: type: array description: Array of approval sections items: type: object properties: id: $ref: '#/components/schemas/Uuid' active: type: boolean description: indicates if section is active or not type: type: string description: > The organizational dimension type this section covers. DEPARTMENT — based on organizational unit structure; DIMENSION — based on a custom expense dimension. example: DEPARTMENT enum: - DEPARTMENT - DIMENSION numberOfRequiredApprovals: type: integer description: >- Number of sequential approvals required before an expense report can proceed. minimum: 1 maximum: 3 sendToUnauthorizedApprovers: type: boolean description: indicates if report can be send to unauthorized approvers sortOrder: type: integer description: a sort number of the section in the list format: int32 customDimensionDefinition: type: object description: >- a data about custom dimension on which section is created on, if the section is created for one properties: id: $ref: '#/components/schemas/Uuid' name: type: string description: name of custom dimension maxLength: 255 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) securitySchemes: bearerAuth: type: http scheme: bearer ````