Skip to content

Close AccountPOST

Overview

Closes a checking deposit account for a customer. 1

Warning

Closing an account will irreversibly close all cards associated with the account.

Endpoint URL

https://api-s.nolantechnologies.com/v0/banking/accounts/:accountId/close

Endpoint Data

Property Name Description Type Required Allowed Values
reason Account closure reson String Yes ByCustomer, Fraud, NegativeBalance
Example Body
{
    "customerId": "1234567"
}
Parameter Name Description
accountId Unit account ID

Example Request

curl -i -X POST "https://api-s.nolantechnologies.com/v0/banking/accounts/1234567/close" \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  -H "X-Nolan-API-Key: YourNolanApiKey" \
  --data '{
    "reason": "ByCustomer"
}'

Example Response

HTTP/1.1 200 OK
X-Powered-By: Express
Content-Type: application/json; charset=utf-8
Content-Length: 332
ETag: W/"14c-PIXt+3CWLR/8LXvJ5oHPfhWsbyg"
Date: Sat, 23 Sep 2023 20:51:38 GMT
Connection: keep-alive
Keep-Alive: timeout=5

{
    "data": {
        "id": "1234567",
        "type": "depositAccount",
        "customerId": "1086957",
        "createdAt": "2023-08-26T16:05:10.116Z",
        "name": "Jamie Dimon",
        "depositProduct": "checking",
        "routingNumber": "812345678",
        "accountNumber": "1001784432",
        "currency": "USD",
        "available": -200,
        "balance": -200,
        "hold": 0,
        "status": "Closed",
        "tags": {},
        "closeReason": "ByCustomer"
    }
}

  1. Read more about this endpoint in the Unit API docs ↩