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

# Delete tax code value

> Permanently deletes a value from a tax code. Returns 400 when the value is in use and cannot be deleted. Returns 403 when the organization does not exist or the authenticated user is not an administrator of it. Returns 404 when the tax code or the value is not found.




## OpenAPI

````yaml /openapi/findity-admin-api.json delete /organizations/{organizationId}/taxcodes/{taxCodeId}/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}/taxcodes/{taxCodeId}/values/{valueId}:
    delete:
      tags:
        - Tax codes
      summary: Delete tax code value
      description: >
        Permanently deletes a value from a tax code. Returns 400 when the value
        is in use and cannot be deleted. Returns 403 when the organization does
        not exist or the authenticated user is not an administrator of it.
        Returns 404 when the tax code or the value is not found.
      operationId: adminDeleteTaxCodeValue
      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 value to delete (32-character
            hex string), as returned in the `id` field of the list or GET
            response.
          schema:
            type: string
            example: 63b7a7802a644e8ca296c9796ffa7074
        - name: valueId
          in: path
          required: true
          description: >-
            String. The ID of the tax code value to delete, as returned in the
            `id` field of the list values response.
          schema:
            type: string
            example: VAT25
      responses:
        '204':
          description: No Content — tax code value successfully deleted
        '400':
          description: Bad request — tax code value is in use and cannot be deleted
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/400Error'
              example:
                result: error
                code: TAX_CODE_VALUE_IN_USE
                description: Tax code value is in use and cannot be deleted.
        '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 or value does not exist
          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
                Tax code value not found:
                  value:
                    result: error
                    code: TAX_CODE_VALUE_NOT_FOUND
                    description: Tax code value not found
components:
  schemas:
    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}'
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer

````