---
title: "Get the account balance"
method: GET
path: "/account"
tags: ["account"]
---

# Get the account balance

`GET /account`

## Request

- Base URL: `https://api.mobilevalidate.com/v1`
- URL: `https://api.mobilevalidate.com/v1/account`
- Auth: HTTP bearer

Balance, reserved amount and today's usage (UTC) of the key's account. Needs `account:read`.

## Response `200`

The account.

- object
  - `object` 'account', required
  - `org_id` string, required
  - `name` string
  - `livemode` boolean
  - `balance` Money, required
    - `amount` string, required: Decimal USD amount.
    - `currency` 'USD', required
  - `reserved` Money, required
    - `amount` string, required: Decimal USD amount.
    - `currency` 'USD', required
  - `today` object
    - `numbers` integer: Live identifiers checked today.
    - `billed_units` integer
    - `cost` Money
      - `amount` string, required: Decimal USD amount.
      - `currency` 'USD', required
    - `resets_at` string, date-time

## Other responses

- `default`: Error. Branch on `error.code`; `suggestion` (optional) says how to fix the request. A known path called with the wrong method answers `404 not_found` with an `Allow` header listing the methods it accepts.

---

[API](https://skmtc.dev/mobilevalidate/apis/mobilevalidate-api.md) · [All operations](https://skmtc.dev/mobilevalidate/apis/mobilevalidate-api/llms.txt) · [OpenAPI document](https://skmtc.dev/mobilevalidate/apis/mobilevalidate-api/revisions/f2e56c2454ef?raw)