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

# V0 - Get the list of approvers on values (externalId)

> Returns the values of a custom dimension's list together with each value's approver assignment — the people who can approve expenses tagged with that value. Sub-variant of `GET .../list/` with approver detail included; useful when building approval-workflow administration UIs.



## OpenAPI

````yaml openapi/findity-admin-api-1.json GET /organizations/externalid/{externalId}/customdimensions/{definitionExternalId}/list/approvers/
openapi: 3.0.3
info:
  title: Findity Admin API
  description: ''
  version: 1.0.0
  contact:
    name: Findity Support
    email: support@findity.com
servers:
  - url: https://stage-expense.findity.com/api/admin
    description: Stage environment
  - url: https://expense.findity.com/api/admin
    description: Production environment
security:
  - bearerAuth: []
paths:
  /organizations/externalid/{externalId}/customdimensions/{definitionExternalId}/list/approvers/:
    get:
      tags:
        - dimension lists
      summary: V0 - Get the list of approvers on values (externalId)
      description: >-
        Returns the values of a custom dimension's list together with each
        value's approver assignment — the people who can approve expenses tagged
        with that value. Sub-variant of `GET .../list/` with approver detail
        included; useful when building approval-workflow administration UIs.
      operationId: 073d7b4a-b6f5-4902-ad53-554a76ac178d
      parameters:
        - $ref: '#/components/parameters/externalId'
        - $ref: '#/components/parameters/definitionExternalId'
        - name: X-Findity-ApiVersion
          in: header
          schema:
            type: string
            default: '3'
          description: Findity API version. Use `3` for the current admin API.
      responses:
        '200':
          description: OK
          content:
            application/json:
              example:
                listKey: >-
                  CUSTOM_DIMENSIONS_b1c2d3e4f5a6b1c2d3e4f5a6b1c2d3e4_8ab28cb36ccde07d016ccdfb47d00216
                lastUpdated: '2026-05-22T07:15:54Z'
                totalValueCount: 3
                values:
                  - id: proj-001
                    value: Website redesign
                    sortOrder: 0
                    startDate: null
                    endDate: null
                    tag: null
                    approvers:
                      - id: 2c85656820284f1183a3b9865e1864ee
                        externalSourceId: emp-jane-smith
                        amountLimit: null
                        sortOrder: 0
                        fromDate: null
                        toDate: null
                        personId: 8ab28c4e797a953501797e6b7b4318df
                        personName: Jane Smith
                        personEmail: jane.smith@example.com
                        personExternalSourceId: emp-jane-smith
                  - id: proj-002
                    value: Mobile app v2
                    sortOrder: 1
                    startDate: null
                    endDate: null
                    tag: null
                    approvers:
                      - id: 3d96767931395a2294b4c0976f2975ff
                        externalSourceId: emp-john-doe
                        amountLimit: null
                        sortOrder: 0
                        fromDate: null
                        toDate: null
                        personId: 8ab28c4e797a953501797e6b7b4319f0
                        personName: John Doe
                        personEmail: john.doe@example.com
                        personExternalSourceId: emp-john-doe
                      - id: 4ea7878a42406b3305c5d1087a3a86b0
                        externalSourceId: emp-carol-park
                        amountLimit: null
                        sortOrder: 1
                        fromDate: null
                        toDate: null
                        personId: 8ab28c4e797a953501797e6b7b431a01
                        personName: Carol Park
                        personEmail: carol.park@example.com
                        personExternalSourceId: emp-carol-park
                  - id: proj-003
                    value: Internal tools refresh
                    sortOrder: 2
                    startDate: null
                    endDate: null
                    tag: null
                    approvers: []
        '404':
          description: Not found
          content:
            application/json:
              example:
                result: error
                description: organization not found
components:
  parameters:
    externalId:
      in: path
      name: externalId
      required: true
      description: The external source id of the organization
      schema:
        type: string
      example: 6aeb86c4fb154c46b2b5a1977245ac67
    definitionExternalId:
      in: path
      name: definitionExternalId
      required: true
      description: The external id of the dimension
      schema:
        type: string
      example: 6aeb86c4fb154c46b2b5a1977245ac67
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer

````