---
title: "Update account status"
---
You can change an account's status to suspend it, reactivate it, or close it. Use this to freeze an account during a dispute, or to close one a customer no longer needs.

## Account statuses

| Status    | What it means                                                      |
| :-------- | :--------------------------------------------------------------- |
| `active`  | the account works normally and can send and receive funds         |
| `frozen`  | the account is suspended; transactions are blocked until reactivated |
| `deleted` | the account is closed and can't be used or changed again          |

## Update the status

Use the [Update account status](/api-reference/accounts/patch-v1-accounts-account-id-status) endpoint. Send the account ID in the path and the new `status` in the body:

```bash title="update account status request"
curl --request PATCH \
     --url https://api.gravv.xyz/v1/accounts/a4d83e55-435e-41c9-9a0b-dcb99f690c95/status \
     --header 'Api-Key: <API_KEY>' \
     --header 'content-type: application/json' \
     --data '
{
  "status": "frozen"
}
'
```

The response returns the updated account:

```json title="update account status response"
{
  "data": {
    "id": "a4d83e55-435e-41c9-9a0b-dcb99f690c95",
    "currency": "USD",
    "label": "Jane Doe",
    "type": "regular",
    "status": "frozen",
    "customer_id": "d12ded01-9081-4a3c-a76c-70654f0a0175",
    "blockchain_network": "polygon"
  },
  "error": null
}
```

To reactivate a frozen account, send the same request with `"status": "active"`.

> 📘 Before you close an account
>
> Closing an account (`deleted`) requires its wallet balance to be zero, so withdraw or transfer any funds first. A deleted account is final and can't be changed again. System-managed accounts, such as fee and auto-sweep accounts, can't have their status changed.