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

# get_account — Retrieve a single account

> Reference for the get_account MCP tool. Fetch one account by its ID for a given organization with accounts.read scope and balance details.

The `get_account` tool returns a single account by `accountId` within an organization, including balance information when available. Use it when your agent already knows the account ID and needs full details. `intent`, `organizationId`, and `accountId` are required, and the token must carry the `accounts.read` scope.

## Scope

Required OAuth scope: `accounts.read`

## Input

**organizationId** `string` *required*

The organization that owns the account. Must be one of the organizations the token can access.

**accountId** `string` *required*

The unique account identifier to retrieve.

**intent** `string` *required*

What the user asked for and why this call serves it, in 1 to 500 characters. Required on every tool call. See [Common tool arguments](https://mcp.docs.relayfi.com/concepts/transport.md#common-tool-arguments).

## Output

**data** `Account` *required*

The requested account object.

**Account**

**object** `string` *required*

Always `"account"`.

**id** `string` *required*

Unique account identifier.

**organizationId** `string` *required*

Organization the account belongs to.

**name** `string` *required*

Display name of the account.

**type** `string` *required*

Account type. Values: `checking`, `savings`, `credit`, `external`.

**status** `string` *required*

Account status. Values: `open`, `frozen`, `closed`.

**currency** `string` *required*

Always `"USD"`.

**balances** `object`

Balance values as [Money](https://mcp.docs.relayfi.com/concepts/results.md#money) objects. Omitted when unavailable or not readable. Absence never means zero: your agent must not report a missing balance as \$0.

**Balances**

**available** `Money`

Available balance.

**current** `Money`

Current balance.

**pending** `Money`

Pending balance.

**accountNumberLast4** `string` *required*

Last four digits of the account number. Only four digits are ever returned.

**createdAt** `string` *required*

Timestamp when the account was created, in RFC 3339 format.

## Example

```json Request theme={null}
{
  "jsonrpc": "2.0",
  "id": 5,
  "method": "tools/call",
  "params": {
    "name": "get_account",
    "arguments": {
      "intent": "User asked for the current balance of their Operating account.",
      "organizationId": "org_1",
      "accountId": "acc_1"
    }
  }
}
```

```json Response theme={null}
{
  "jsonrpc": "2.0",
  "id": 5,
  "result": {
    "structuredContent": {
      "data": {
        "object": "account",
        "id": "acc_1",
        "organizationId": "org_1",
        "name": "Operating",
        "type": "checking",
        "status": "open",
        "currency": "USD",
        "balances": {
          "available": { "cents": 100000, "display": "1,000.00", "currency": "USD" },
          "current": { "cents": 120000, "display": "1,200.00", "currency": "USD" },
          "pending": { "cents": 20000, "display": "200.00", "currency": "USD" }
        },
        "accountNumberLast4": "1234",
        "createdAt": "2026-01-04T00:00:00.000Z"
      }
    }
  }
}
```

## Notes

* The `balances` object may be omitted when balances are unavailable or not readable. Absence never means zero. Your agent must not report a missing balance as \$0.
* Only the last four digits of the account number are ever returned via `accountNumberLast4`.
* If the account does not exist or is not accessible with the provided token, the tool returns an MCP error: `Account not found or not accessible.`

> [card] [list\_accounts](https://mcp.docs.relayfi.com/tools/list-accounts.md)
>
> List all accounts for an organization with pagination.

> [card] [Errors](https://mcp.docs.relayfi.com/concepts/errors.md)
>
> Learn how MCP tool errors and HTTP auth failures are surfaced.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.