> ## 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. # List tax code values > Returns a paginated list of values for the given tax code. Returns an empty list if the tax code exists but has no values configured yet. Returns 403 when the organization does not exist or the authenticated user is not an administrator of it. Returns 404 when the tax code does not exist or has already been deleted. ## OpenAPI ````yaml /openapi/findity-admin-api.json get /organizations/{organizationId}/taxcodes/{taxCodeId}/values 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}/taxcodes/{taxCodeId}/values: get: tags: - Tax codes summary: List tax code values description: > Returns a paginated list of values for the given tax code. Returns an empty list if the tax code exists but has no values configured yet. Returns 403 when the organization does not exist or the authenticated user is not an administrator of it. Returns 404 when the tax code does not exist or has already been deleted. operationId: adminListTaxCodeValues 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: taxCodeId in: path required: true description: >- String. The ID of the tax code whose values to list (32-character hex string), as returned in the `id` field of the list or GET response. schema: type: string example: 63b7a7802a644e8ca296c9796ffa7074 - name: searchText in: query required: false description: >- String. Filters values by a partial, case-insensitive match on the display text (`value`). schema: type: string example: '25' - name: sort in: query required: false description: > String. One or more sorting criteria in `field:direction` format, combined either as a comma-separated list (`sortOrder:asc,startDate:desc`) or as repeated query parameters (`sort=sortOrder:asc&sort=startDate:desc`). Supported fields: `sortOrder`, `startDate`, `endDate`. Supported directions: `asc`, `desc`. Defaults to `sortOrder:asc`. Unsupported or unknown fields (e.g. `value`) are not an error — the request silently falls back to the default. schema: type: string default: sortOrder:asc example: sortOrder:asc,startDate:desc - name: max in: query required: false description: Integer. Maximum number of results to return per page. schema: type: integer minimum: 1 maximum: 1000 default: 10 - name: offset in: query required: false description: >- Integer. Zero-based offset of the first result to return. Used for pagination. schema: type: integer minimum: 0 default: 0 responses: '200': description: >- OK — returns an empty list if the tax code has no values configured yet content: application/json: schema: $ref: '#/components/schemas/ArrayOfAdminApiTaxCodeValues' example: meta: count: 2 total: 2 data: - id: VAT25 value: 25% sortOrder: 0 startDate: null endDate: null - id: VAT12 value: 12% sortOrder: 1 startDate: '2024-01-01T00:00:00Z' endDate: '2024-12-31T23:59:59Z' '400': description: Bad request — invalid query parameter value content: application/json: schema: $ref: '#/components/schemas/400Error' examples: Invalid max value: value: result: error code: GENERIC description: 'max must be between an integer between 1 and 1000 was: 0' '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 — tax code does not exist or has already been deleted content: application/json: schema: $ref: '#/components/schemas/404Error' examples: Tax code not found: value: result: error code: TAX_CODE_NOT_FOUND description: Tax code not found components: schemas: ArrayOfAdminApiTaxCodeValues: type: object properties: meta: type: object properties: count: type: integer description: Number of tax code values returned in this response page. total: type: integer description: >- Total number of tax code values matching the query across all pages. required: - count - total data: type: array items: $ref: '#/components/schemas/AdminApiTaxCodeValue' required: - meta - data 400Error: type: object properties: result: type: string code: type: string description: type: string 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}' AdminApiTaxCodeValue: type: object required: - id - value properties: id: type: string description: Unique identifier of the tax code value. value: type: string description: Display text of the tax code 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 securitySchemes: bearerAuth: type: http scheme: bearer ````