---
title: "Close external account"
method: POST
path: "/payments/external_accounts/{external_account_id}/close"
tags: ["Payments"]
---

# Close external account

`POST /payments/external_accounts/{external_account_id}/close`

Closes an external account previously linked to a participant. After closure the account can no longer be used for new payments.

## Path parameters

- `external_account_id` string, uuid, required

## Headers

- `X-SCX-SIGNED` string, required
- `X-SCX-TIMESTAMP` string, required

## Request body

- PostCloseExternalAccountRequest
  - `participant_code` string, required — Participant that owns the external account being closed.

## Response `200`

External account closed. Response contains the final snapshot of the account.

- PostCloseExternalAccountResponse
  - `request_id` string — RequestID
  - `external_account` object
    - `account_number` string — Bank account number
    - `routing_number` string — Routing number, routing number needs to be 9 characters and can only be integers [0-9]
    - `participant_code` string — Participant code
    - `platform_code` string — Platform code
    - `account_nickname` string — Account nickname
    - `account_type` 'checking' | 'savings' — Fiat account type
    - `status` 'pending' | 'approved' | 'rejected' | 'locked' | 'disabled' | 'revoked' | 'closed' — Account status
    - `external_account_id` string — Linked account id
    - `created_at` string, date-time — Creation timestamp of the account.

## Other responses

- `400` — Bad Request
- `403` — Forbidden
- `404` — Not Found
- `500` — Internal Server Error
- `503` — Service Unavailable

---

[API](https://skmtc.net/zerohash/apis/zerohash-api.md) · [All operations](https://skmtc.net/zerohash/apis/zerohash-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/zerohash/zerohash-api/revisions/8b647d934363/schema)