---
title: "Check Real Time Account Balance (Processors Only)"
method: POST
path: "/account/check_balance"
tags: ["processor token"]
---

# Check Real Time Account Balance (Processors Only)

`POST /account/check_balance`

Check the real-time account balance using your access token.

## Response `200`

OK

- MemberResponseBody
  - `member` MemberResponse
    - `aggregated_at` string, nullable
    - `background_aggregation_is_disabled` boolean
    - `connection_status` string, nullable
    - `connection_status_message` string, nullable
    - `guid` string, nullable
    - `id` string, nullable
    - `institution_code` string, nullable
    - `institution_guid` string
    - `is_being_aggregated` boolean, nullable
    - `is_managed_by_user` boolean, nullable
    - `is_manual` boolean, nullable
    - `is_oauth` boolean, nullable
    - `metadata` string, nullable
    - `most_recent_job_detail_code` integer, nullable
    - `most_recent_job_detail_text` boolean, nullable
    - `most_recent_job_guid` boolean, nullable
    - `name` string, nullable
    - `needs_updated_credentials` boolean, nullable
    - `oauth_window_uri` string, nullable
    - `successfully_aggregated_at` string, nullable
    - `use_cases` string[] — The use case associated with the member. Valid values are `PFM` and/or `MONEY_MOVEMENT`. Only set this if you've met with MX and have opted in to using this field.
    - `user_guid` string, nullable
    - `user_id` string, nullable

## Changes

> 50 revisions in range; 1 not diffed.

- **2025-11-05** `e74cd2b059b5` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/mx/apis/mx-platform-api/changes/account/check_balance/post.md)

---

[API](https://skmtc.dev/mx/apis/mx-platform-api.md) · [All operations](https://skmtc.dev/mx/apis/mx-platform-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/mx/mx-platform-api/revisions/b6632646ee89/schema)