> ## Documentation Index
> Fetch the complete documentation index at: https://apidocs.taxwire.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Delete customer

> Delete a customer and its exemption certificates. Returns 204 with no body, including when the customer was already deleted, so a retry is safe. A deleted customer keeps its `source`, `source_account_id` and `source_id`, so creating it again is a 409 with `meta.deleted: true`; restore it in the Taxwire app instead.



## OpenAPI

````yaml DELETE /customers/{customer_id}
openapi: 3.1.0
info:
  title: Taxwire Public API
  version: 0.1.0
servers: []
security: []
paths:
  /customers/{customer_id}:
    delete:
      tags:
        - Customers
      summary: Delete Customer
      description: >-
        Delete a customer and its exemption certificates. Returns 204 with no
        body, including when the customer was already deleted, so a retry is
        safe. A deleted customer keeps its `source`, `source_account_id` and
        `source_id`, so creating it again is a 409 with `meta.deleted: true`;
        restore it in the Taxwire app instead.
      operationId: delete_customer_customers__customer_id__delete
      parameters:
        - name: customer_id
          in: path
          required: true
          schema:
            type: string
            description: Unique identifier for the customer.
            title: Customer Id
          description: Unique identifier for the customer.
      responses:
        '204':
          description: Successful Response
        '404':
          description: No customer with this ID exists in your organization.
        '422':
          description: Validation Error - Invalid input data
          content:
            application/json:
              example:
                errors:
                  - status: '422'
                    code: validation_required_field
                    title: Missing source_id
                    detail: Please provide a value for the required source_id field
                    source:
                      pointer: /data/attributes/source_id
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '429':
          description: Rate limit exceeded. Try again later.
          headers:
            Retry-After:
              schema:
                type: string
              description: Time in seconds until the rate limit resets
            X-RateLimit-Limit:
              schema:
                type: string
              description: The rate limit ceiling for the given request
            X-RateLimit-Remaining:
              schema:
                type: string
              description: The number of requests remaining in the time window
          content:
            application/json:
              example:
                errors:
                  - status: '429'
                    code: rate_limit_error
                    title: Too Many Requests
                    detail: Rate limit exceeded
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '500':
          description: Internal Server Error
          content:
            application/json:
              example:
                errors:
                  - status: '500'
                    code: system_internal_error
                    title: Internal Error
                    detail: An unexpected error occurred. Our team has been notified.
              schema:
                $ref: '#/components/schemas/ErrorResponse'
      security:
        - APIKeyHeader: []
        - HTTPBearer: []
components:
  schemas:
    ErrorResponse:
      properties:
        errors:
          items:
            $ref: '#/components/schemas/Error'
          type: array
          title: Errors
      type: object
      required:
        - errors
      title: ErrorResponse
      description: Standardized JSON:API error response model.
    Error:
      properties:
        status:
          type: string
          title: Status
        code:
          type: string
          title: Code
        title:
          type: string
          title: Title
        detail:
          type: string
          title: Detail
        source:
          anyOf:
            - $ref: '#/components/schemas/ErrorSource'
            - type: 'null'
        meta:
          anyOf:
            - additionalProperties: true
              type: object
            - type: 'null'
          title: Meta
      type: object
      required:
        - status
        - code
        - title
        - detail
      title: Error
      description: Individual JSON:API error object.
    ErrorSource:
      properties:
        pointer:
          anyOf:
            - type: string
            - type: 'null'
          title: Pointer
      type: object
      title: ErrorSource
      description: Identifies the source of the error, e.g., via a JSON Pointer.
  securitySchemes:
    APIKeyHeader:
      type: apiKey
      in: header
      name: X-API-Key
    HTTPBearer:
      type: http
      scheme: bearer

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.