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

> Soft-deletes a tax code. The tax code is marked as deleted and will no longer appear in list or get responses. 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 delete /organizations/{organizationId}/taxcodes/{taxCodeId}
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}:
    delete:
      tags:
        - Tax codes
      summary: Delete tax code
      description: >
        Soft-deletes a tax code. The tax code is marked as deleted and will no
        longer appear in list or get responses. 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: adminDeleteTaxCode
      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 to delete (32-character hex string),
            as returned in the `id` field of the list or GET response.
          schema:
            type: string
            example: 63b7a7802a644e8ca296c9796ffa7074
      responses:
        '204':
          description: No Content — tax code successfully 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 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:
    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

````