# List position URL: https://docs.hanzo.ai/docs/openapi/books/get-books-position > Returns the org's Balance Sheet as of `to` (empty = all time), with the Assets == Liabilities + Equity equation proof. `GET /v1/books/position` > [Books →](https://docs.hanzo.ai/docs/openapi/books) · [All API references →](https://docs.hanzo.ai/docs/openapi) · [Get started →](https://docs.hanzo.ai/docs/guides) | | | | ------------- | ---------------------------------------- | | **Address** | `https://api.hanzo.ai/v1/books/position` | | **Method** | `GET` | | **Operation** | `get_books_position` | | **Auth** | `Authorization: Bearer $HANZO_API_KEY` | Returns the org's Balance Sheet as of `to` (empty = all time), with the Assets == Liabilities + Equity equation proof. ## Request 2 fields. | Field | In | Type | Required | Description | | --------- | ----- | ------ | -------- | ----------------------------------------------------------------- | | `sandbox` | query | string | — | Sandbox reads the org's SANDBOX ledger when it is exactly "true". | | `to` | query | string | — | To is the RFC3339 instant the statement is struck as of. | ## Response | Status | Body | Meaning | | --------- | ------------------ | ------- | | `200` | books.BalanceSheet | ok | | `default` | problem-details | refused | `200` body — 20 fields. | Field | In | Type | Always | Description | | ----------------------- | ---- | -------------------- | ------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `asOf` | body | string | — | AsOf is the posting time the statement is taken at, inclusive. | | `assets` | body | books.BalanceLine\[] | — | Assets are what the org OWNS at that instant, one line per account that has a balance. | | `assets[].account` | body | string | — | Account is the chart-of-accounts number this line reports on. | | `assets[].amount` | body | integer (int64) | — | Amount is the balance as of the statement date, in whole cents, in its NATURAL sign: positive when the account behaved normally, on all three sides. | | `assets[].name` | body | string | — | Name is the account's human name, or the derived line's own name. | | `assets[].type` | body | string | — | Type is the account's fundamental class. | | `balanced` | body | boolean | — | Balanced is whether assets equal liabilities plus equity — the accounting equation, computed from the totals above rather than assumed. | | `equity` | body | books.BalanceLine\[] | — | Equity is what is left over for the owners. | | `equity[].account` | body | string | — | Account is the chart-of-accounts number this line reports on. | | `equity[].amount` | body | integer (int64) | — | Amount is the balance as of the statement date, in whole cents, in its NATURAL sign: positive when the account behaved normally, on all three sides. | | `equity[].name` | body | string | — | Name is the account's human name, or the derived line's own name. | | `equity[].type` | body | string | — | Type is the account's fundamental class. | | `liabilities` | body | books.BalanceLine\[] | — | Liabilities are what the org OWES — including customers' unspent prepaid credit, which is their money until it is consumed and so is carried here rather than counted as revenue. | | `liabilities[].account` | body | string | — | Account is the chart-of-accounts number this line reports on. | | `liabilities[].amount` | body | integer (int64) | — | Amount is the balance as of the statement date, in whole cents, in its NATURAL sign: positive when the account behaved normally, on all three sides. | | `liabilities[].name` | body | string | — | Name is the account's human name, or the derived line's own name. | | `liabilities[].type` | body | string | — | Type is the account's fundamental class. | | `totalAssets` | body | integer (int64) | — | TotalAssets is the sum of the asset lines, in cents. | | `totalEquity` | body | integer (int64) | — | TotalEquity is the sum of the equity lines including retained earnings, in cents. | | `totalLiabilities` | body | integer (int64) | — | TotalLiabilities is the sum of the liability lines, in cents. | Failure carries the platform error shape — see [Errors](https://docs.hanzo.ai/docs/errors). ## Examples **CLI** ```bash hanzo books position ``` **SDK** **.ts** ```ts import { Configuration, BooksApi } from 'hanzoai'; const api = new BooksApi(new Configuration({ accessToken: process.env.HANZO_API_KEY })); const { data } = await api.getBooksPosition(); ``` **.py** ```python from hanzoai.cloud import ApiClient, Configuration from hanzoai.cloud.api import BooksApi client = ApiClient(Configuration(access_token=os.environ["HANZO_API_KEY"])) result = BooksApi(client).get_books_position() ``` **.go** ```go cfg := hanzoai.NewConfiguration() cfg.AddDefaultHeader("Authorization", "Bearer "+os.Getenv("HANZO_API_KEY")) client := hanzoai.NewAPIClient(cfg) resp, _, err := client.BooksAPI.GetBooksPosition(context.Background()).Execute() if err != nil { return err } ``` **.rs** ```rust use hanzo_client::apis::{configuration::Configuration, books_api}; let mut cfg = Configuration::new(); cfg.bearer_access_token = std::env::var("HANZO_API_KEY").ok(); let result = books_api::get_books_position(&cfg, Default::default()).await?; ``` **.java** ```java import ai.hanzo.cloud.ApiClient; import ai.hanzo.cloud.api.BooksApi; ApiClient client = new ApiClient(); client.setBearerToken(System.getenv("HANZO_API_KEY")); var result = new BooksApi(client).getBooksPosition(); ``` **HTTP** ```bash curl https://api.hanzo.ai/v1/books/position \ -H "Authorization: Bearer $HANZO_API_KEY" ``` **MCP** MCP reaches **books** through the `books` tool, which names its 20 operations with its own verbs — this one among them, under a name only MCP declares. `describe` explains any of them: ```bash curl -X POST https://api.hanzo.ai/v1/mcp \ -H "Content-Type: application/json" \ -d '{ "jsonrpc": "2.0", "id": 1, "method": "tools/call", "params": { "name": "describe", "arguments": { "op": "list_book_accounts" } } }' ``` --- [Books API](https://docs.hanzo.ai/docs/openapi/books) · [All Hanzo APIs](https://docs.hanzo.ai/docs/openapi) · [Interactive reference](https://docs.hanzo.ai/docs/openapi/reference)