> For the complete documentation index, see [llms.txt](https://docs.udara360.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.udara360.io/udara360-docs-1/operations/get-till-balance-by-acct-no.md).

# Get Till Balance By Acct No

To retrieve a till account's balance, make a <mark style="color:green;">`GET`</mark> request to this endpoint, passing the till's account number as the `AccountNumber` query parameter.

A successful request returns the linked `userID`, `accountName`, `accountNumber`, and current `ledgerBalance` of the till.

This process allows you to check how much cash a till is currently holding, useful before approving a cash withdrawal or during end-of-day reconciliation.

<mark style="color:green;">`GET`</mark> `/api/Operations/v1/GetTillBalanceByAccountNumber`

**Headers**

| Name                                                | Value                | Description                                 |
| --------------------------------------------------- | -------------------- | ------------------------------------------- |
| Content-Type<mark style="color:red;">\*</mark>      | `application/json`   | Format of the request payload               |
| Authorization<mark style="color:red;">\*</mark>     | `bearer {token}`     | Access token obtained from Get Access Token |
| request-reference<mark style="color:red;">\*</mark> | `{unique_reference}` | A unique reference identifying this request |

**Params**

<table><thead><tr><th>Name</th><th>Data Type (Length)</th><th data-type="checkbox">Required</th><th>Description</th></tr></thead><tbody><tr><td><code>AccountNumber</code></td><td>string</td><td>true</td><td>The till account number to retrieve the balance for</td></tr></tbody></table>

**Body**

| Name            | Data Type | Description                                             |
| --------------- | --------- | ------------------------------------------------------- |
| `userID`        | string    | Unique ID of the teller/user linked to the till account |
| `accountName`   | string    | Name on the till account                                |
| `accountNumber` | string    | The till account number                                 |
| `ledgerBalance` | number    | Current balance held on the till account                |

Here is an example request and response with a sample payload sent to the endpoint in Curl format.

<details>

<summary>Sample Request</summary>

```json
curl --location -g '{{baseurl}}/api/Operations/v1/GetTillBalanceByAccountNumber?AccountNumber=10103056' \
--header 'Authorization: bearer {token}' \
--header 'request-reference: {unique_reference}' \
--header 'Content-Type: application/json' \
--data ''
```

</details>

<details>

<summary>Response : <code>200</code></summary>

```
{
  "status": true,
  "message": "string",
  "data": {
    "userID": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
    "accountName": "string",
    "accountNumber": "string",
    "ledgerBalance": 0
  }
}
```

</details>