# Budget

## Get Spending Power

<mark style="color:blue;">`GET`</mark> `https://api.omnimoney.app/v1/budget/spending_power`

This endpoint fetches the current month's remaining spending power. By default, it fetches the spending power for the current month (UTC timezone). However, you can specify a month using the `year_month` query paramater.

#### Query Parameters

| Name        | Type   | Description                                                                                              |
| ----------- | ------ | -------------------------------------------------------------------------------------------------------- |
| year\_month | string | The month to fetch the spending power for in the format YYYY-MM. For example, July 2021 would be 2021-07 |

#### Headers

| Name           | Type   | Description          |
| -------------- | ------ | -------------------- |
| Authentication | string | Bearer ACCESS\_TOKEN |

{% tabs %}
{% tab title="200 Success" %}

```
{
    "spending_power": 243.76
}
```

{% endtab %}

{% tab title="400 Only sends if the year\_month query paramter was provided but in an incorrect format." %}

```
"`year_month` must be in format YYYY-MM"
```

{% endtab %}
{% endtabs %}
