> ## 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 - List dimensions (externalId)

> Lists all custom dimension definitions configured on the organization. Custom dimensions appear on expenses or expense reports as additional fields (free text or selectable lists). Only definitions whose lifecycle status is not `DELETED` are returned.



## OpenAPI

````yaml openapi/findity-admin-api-1.json GET /organizations/externalid/{externalId}/customdimensions/
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/:
    get:
      tags:
        - dimensions
      summary: V0 - List dimensions (externalId)
      description: >-
        Lists all custom dimension definitions configured on the organization.
        Custom dimensions appear on expenses or expense reports as additional
        fields (free text or selectable lists). Only definitions whose lifecycle
        status is not `DELETED` are returned.
      operationId: 72a0daeb-3248-4ed5-a3e1-a886d02b9eb8
      parameters:
        - $ref: '#/components/parameters/externalId'
        - 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: >-
            Custom dimension definitions for the organization, excluding any
            that have been deleted.
          content:
            application/json:
              example:
                - id: 5e1a8d1b3c4f4d2db8a6e1d7c2f5a3b9
                  definition: null
                  description: Project
                  type: CUSTOM
                  level: EXPENSE
                  presetLocation: NONE
                  controlType: LIST_SEARCHABLE
                  userOverridable: true
                  externalSourceId: project
                  useDateInterval: false
                  recipientId: null
                  useAsRecipientFilter: false
                  visibleIfNoPreset: true
                  hideDimensionValues: false
                  usedInCarbonFootprint: false
                  deviateOnCreditRow: false
                  deviatingCreditRowValue: null
components:
  parameters:
    externalId:
      in: path
      name: externalId
      required: true
      description: The external source id of the organization
      schema:
        type: string
      example: 6aeb86c4fb154c46b2b5a1977245ac67
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer

````