> ## 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 setup

> Returns the main approval setup of 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
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:
    get:
      tags:
        - Approval
      summary: Get approval setup
      description: >
        Returns the main approval setup of the organization. The
        `organizationId` path parameter supports both the Findity id and the
        partner-side `externalId`.
      operationId: adminGetApproval
      parameters:
        - $ref: '#/components/parameters/organizationIdOrExternalIdInPath'
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Approval'
              examples:
                Approval setup example:
                  value:
                    id: ff8080819e01726d019e0172adb90350
                    numberOfRequiredApprovals: 3
                    requiresApproval: true
                    defaultApprover:
                      firstName: firstName
                      lastName: lastName
                      id: ff8080819e01726d019e0172af210527
                      email: firstName.lastName@test.com
                      externalId: personIdFromExternalSystem
        '404':
          description: Not found error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/404Error'
              examples:
                Access to approval 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
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
  schemas:
    Approval:
      type: object
      required:
        - id
        - requiresApproval
      properties:
        id:
          allOf:
            - $ref: '#/components/schemas/Uuid'
          readOnly: true
        requiresApproval:
          type: boolean
          description: >
            Indicates whether the organization requires approval for expense
            reports. true = approval is required; false = no approval is
            required.
        numberOfRequiredApprovals:
          type: integer
          minimum: 1
          maximum: 3
          description: >
            Number of sequential approvals an expense report must receive before
            it can proceed. Optional; only applicable when requiresApproval is
            true.
        defaultApprover:
          type: object
          description: >-
            One person has to be set as default approver. Required only when
            requiresApproval is true.
          required:
            - id
          properties:
            id:
              allOf:
                - $ref: '#/components/schemas/Uuid'
              readOnly: true
            firstName:
              type: string
              description: First name of person who has been set as default approver
              maxLength: 255
            lastName:
              type: string
              description: Last name of person who has been set as default approver
              maxLength: 255
            email:
              type: string
              description: e-mail of person who has been set as default approver
              maxLength: 255
            externalId:
              type: string
              description: id from external systemdefined for this person
              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

````