> ## 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 custom dimension value

> Returns a single value from a custom dimension definition by its ID. Returns 403 when the organization does not exist or the authenticated user is not an administrator of it. Returns 404 when the custom dimension definition or the value is not found.




## OpenAPI

````yaml /openapi/findity-admin-api.json get /organizations/{organizationId}/customdimensions/{definitionId}/values/{valueId}
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}/customdimensions/{definitionId}/values/{valueId}:
    get:
      tags:
        - Dimensions
      summary: Get custom dimension value
      description: >
        Returns a single value from a custom dimension definition by its ID.
        Returns 403 when the organization does not exist or the authenticated
        user is not an administrator of it. Returns 404 when the custom
        dimension definition or the value is not found.
      operationId: adminGetCustomDimensionValue
      parameters:
        - name: organizationId
          in: path
          required: true
          description: >
            String. The organization's internal ID (32-character hex string) or
            its `externalSourceId`. When the value matches the format of an
            internal ID, the internal ID takes precedence.
          schema:
            type: string
            example: 11adfe2a080040e3892ffb89c21ec44e
        - name: definitionId
          in: path
          required: true
          description: >-
            String. The ID of the custom dimension definition, as returned in
            the `id` field of the GET definition response.
          schema:
            type: string
            example: abc123def456abc123def456abc123de
        - name: valueId
          in: path
          required: true
          description: >-
            String. The ID of the dimension value to retrieve, as returned in
            the `id` field of the list values response.
          schema:
            type: string
            example: a1b2c3d4e5f6a1b2c3d4e5f6a1b2c3d4
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AdminApiCustomDimensionValue'
              example:
                id: a1b2c3d4e5f6a1b2c3d4e5f6a1b2c3d4
                value: Marketing
                sortOrder: 0
                startDate: null
                endDate: null
        '403':
          description: Forbidden — organization not found or access denied
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/403Error'
              examples:
                Organization not found or access denied:
                  value:
                    result: error
                    description: Organization not found or access denied
        '404':
          description: Not found — custom dimension definition or value does not exist
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/404Error'
              examples:
                Custom dimension definition not found:
                  value:
                    result: error
                    code: CUSTOM_DIMENSION_DEFINITION_NOT_FOUND
                    description: Custom dimension definition not found
                Custom dimension value not found:
                  value:
                    result: error
                    code: CUSTOM_DIMENSION_VALUE_NOT_FOUND
                    description: Custom dimension value not found
components:
  schemas:
    AdminApiCustomDimensionValue:
      type: object
      required:
        - id
        - value
      properties:
        id:
          type: string
          description: Unique identifier of the dimension value.
        value:
          type: string
          description: Display text of the dimension value.
        sortOrder:
          type: integer
          description: Sort position of the value within the list. Null when not set.
          nullable: true
        startDate:
          type: string
          format: date-time
          description: Date from which this value is active. Null when not set.
          nullable: true
        endDate:
          type: string
          format: date-time
          description: Date until which this value is active. Null when not set.
          nullable: true
    403Error:
      type: object
      properties:
        result:
          type: string
        description:
          type: string
      example:
        result: error
        description: Not allowed
    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}'
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer

````