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

# Manage account currencies

> Decide which currencies to enable or turn off on your account. When you enable a currency, we'll automatically create a new budget in that currency.

Decide which currencies to enable or turn off on your account. When you enable a currency, we'll automatically create a new budget in that currency. Similarly, when you [create a budget](../budgets/create-budgets) in a currency, we'll then update the status of that currency on your account.

<Info>
  You can only enable a currency that you can already hold. See [About account currencies](/pages/accounts/about-account-currencies) for more information. If you're still unsure, contact your account manager.
</Info>

## Update a currency

<Note>
  **PATCH** `/v2/currencies/{currencyCode}`
</Note>

### Request

Use this request to update the status of a currency on your account.

<CodeGroup>
  ```bash Sample request theme={null}
  curl -i -X PATCH \
    'https://api.equalsmoney.com/v2/currencies/GBP?accountId=F12345' \
    -H 'Authorization: ApiKey YOUR_API_KEY_HERE' \
    -H 'Content-Type: application/json' \
    -d '{
      "enabled": true
    }'
  ```

  ```bash Request structure theme={null}
  curl -i -X PATCH \
    'https://api.equalsmoney.com/v2/currencies/{currencyCode}?accountId={accountId}' \
    -H 'Authorization: ApiKey YOUR_API_KEY_HERE' \
    -H 'Content-Type: application/json' \
    -d '{
      "enabled": boolean
    }'
  ```
</CodeGroup>

#### Path parameters

<ParamField body="currencyCode" type="string" required>
  The currency code of the currency to work with, in ISO 4217 format.

  Allowable values: 3 characters
</ParamField>

#### Query parameters

<ParamField body="accountId" type="string" required>
  The ID of the account to work with.

  Allowable values: An existing `accountId` (≤ 36 characters)
</ParamField>

#### Request body schema

<ParamField body="enabled" type="boolean">
  Whether or not the currency should be enabled. Set this to `true` to enable a currency.

  Allowable values: `true`, `false`
</ParamField>

### Response

If your request is successful, you'll receive a `200` response containing details about the currency, including its `enabled` status.

<CodeGroup>
  ```json Sample response theme={null}
  {
    "id": "af849178-b239-4661-9140-8ebe467d3541",
    "code": "GBP",
    "name": "Pound Sterling",
    "status": {
      "enabled": true
    }
  }
  ```

  ```json Response structure theme={null}
  {
    "id": "string",
    "code": "string",
    "name": "string",
    "status": {
      "enabled": boolean
    }
  }
  ```
</CodeGroup>

For more detailed information about this request and its response, [see the API reference](/api-reference/currencies/update-a-currency-for-an-account).
