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

# Remove a cardholder

> Removes a cardholder, for example when an employee leaves, and cancels all their cards.

- **Every card the cardholder holds is canceled. This can't be undone.** You receive `card.canceled` for each card.
- Payments already authorised can still settle against the business's card balance.
- A repeat call returns the same cardholder. If the cards couldn't all be canceled, it returns `502 ERRCRD_1009`: repeat it until it succeeds.
- A removed cardholder can't be added again with the same email.
- The business's owner can't be removed.



## OpenAPI

````yaml api-reference/endl-cards-api.json DELETE /api/v0/customer/{businessId}/card-users/{cardholderId}
openapi: 3.1.0
info:
  title: Endl Cards API
  version: '0'
  description: >-
    Issue virtual cards to your customers: enrol them in the card program, fund
    their card balance, issue cards, show card details securely, and follow
    every card transaction with webhook events.


    Paths are under `/api/v0`. The key must carry the **`cards`** permission.
    See the [Cards overview](/api-reference/cards/introduction).
servers:
  - url: https://api-sandbox.endl.io
    description: Sandbox
security:
  - apiKey: []
tags:
  - name: Enrolment
  - name: Cardholders
  - name: Cards
  - name: Card details
  - name: Transactions and balance
  - name: Deposits
  - name: Withdrawals
paths:
  /api/v0/customer/{businessId}/card-users/{cardholderId}:
    delete:
      tags:
        - Cardholders
      summary: Remove a cardholder
      description: >-
        Removes a cardholder, for example when an employee leaves, and cancels
        all their cards.


        - **Every card the cardholder holds is canceled. This can't be undone.**
        You receive `card.canceled` for each card.

        - Payments already authorised can still settle against the business's
        card balance.

        - A repeat call returns the same cardholder. If the cards couldn't all
        be canceled, it returns `502 ERRCRD_1009`: repeat it until it succeeds.

        - A removed cardholder can't be added again with the same email.

        - The business's owner can't be removed.
      parameters:
        - $ref: '#/components/parameters/ApiVersion'
        - $ref: '#/components/parameters/BusinessId'
          description: The enrolled business (`cus_`).
        - name: cardholderId
          in: path
          required: true
          description: The cardholder to remove (`cus_`).
          schema:
            type: string
            example: cus_8Qw2mZ4pL7nR1tY6vB3x
      responses:
        '200':
          description: The cardholder, now `canceled`.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Cardholder'
              example:
                cardholderId: cus_8Qw2mZ4pL7nR1tY6vB3x
                businessId: cus_1Xb7cV4bN7mQ0wE3rT5y
                firstName: Maya
                lastName: Okafor
                email: maya.okafor@example.com
                status: canceled
        '400':
          description: >-
            `ERRCRD_1000` — the customer isn't a business.


            `ERRCRD_1001` — the business isn't enrolled, or its enrolment isn't
            `active`.


            `ERRCRD_1016` — the cardholder is the business's owner, who can't be
            removed. `field` is `cardholderId`.


            `ERRCORE_1001` — `Api-Version` is missing, malformed or unsupported.
            `field` is `Api-Version`.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '401':
          description: '`ERRCORE_1004` — `Api-Key` is missing or not valid.'
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '403':
          description: '`ERRCORE_1005` — the API key doesn''t have the `cards` permission.'
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '404':
          description: >-
            `ERRCRD_1002` — the cardholder doesn't exist or isn't this
            business's.


            `ERRREF_1001` — the customer doesn't exist or isn't yours.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '500':
          description: >-
            `ERRCRD_1030` — an unexpected error. Contact Endl support with the
            `X-Request-ID`.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '502':
          description: >-
            `ERRCRD_1009` — the cardholder was removed but not all their cards
            could be canceled yet. Repeat the call.


            `ERRCRD_1009` — card issuing is temporarily unavailable. Retry with
            backoff, with the same `Idempotency-Key`.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
components:
  parameters:
    ApiVersion:
      name: Api-Version
      in: header
      required: true
      description: >-
        The API version this request targets. `2026-09.1`. See
        [Versioning](/api-reference/versioning).
      schema:
        type: string
        pattern: ^\d{4}-\d{2}\.\d+$
        default: 2026-09.1
      example: 2026-09.1
    BusinessId:
      name: businessId
      in: path
      required: true
      description: A business customer (`cus_`).
      schema:
        type: string
        example: cus_1Xb7cV4bN7mQ0wE3rT5y
  schemas:
    Cardholder:
      type: object
      description: Fields without a value are left out.
      properties:
        cardholderId:
          type: string
          example: cus_8Qw2mZ4pL7nR1tY6vB3x
          description: The cardholder (`cus_`).
        businessId:
          type: string
          example: cus_1Xb7cV4bN7mQ0wE3rT5y
          description: Their business (`cus_`).
        firstName:
          type: string
        lastName:
          type: string
        email:
          type: string
        status:
          type: string
          enum:
            - pending
            - active
            - rejected
            - locked
            - canceled
          description: >-
            `pending` — under review. `active` — approved; cards can be issued.
            `rejected` — not approved. `canceled` — removed; their cards are
            canceled. `locked` is reserved and not returned today.
    Error:
      type: object
      description: >-
        The standard Endl error body. Branch on `errors[].code`, not on the
        message: messages can change. See [Card
        errors](/api-reference/cards/errors).
      properties:
        code:
          type: integer
          description: The HTTP status.
        message:
          type: string
          description: A description of the error.
        status:
          type: string
          enum:
            - ERROR
        data:
          type: 'null'
          description: Always null.
        errors:
          type: array
          description: One or more entries.
          items:
            type: object
            properties:
              code:
                type: string
                description: The error code to branch on, for example `ERRCRD_1022`.
              message:
                type: string
                description: A description you can log or show.
              field:
                type:
                  - string
                  - 'null'
                description: >-
                  The request field, header or path parameter at fault, when
                  there is one.
  securitySchemes:
    apiKey:
      type: apiKey
      in: header
      name: Api-Key
      description: Partner API key. Must carry the `cards` permission.

````

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