> 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/search-till-accounts.md).

# Search Till Accounts

To retrieve till accounts set up for mobile telling, make a <mark style="color:green;">`GET`</mark> request to this endpoint. Pagination and sorting parameters like  `PageNumber`, `PageSize`, `SortColumn`, `Direction`  can optionally be passed to control how results are returned.

A successful request returns each till account's configuration under `data`, including its assigned teller, cash volume limits, and supervisor details, along with a `recordCount` of tills returned.

This process allows you to view or audit every till account available for mobile-based transaction processing.

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

**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>PageNumber</code></td><td>integer</td><td>true</td><td>Page number to retrieve, for paginated results</td></tr><tr><td><code>PageSize</code></td><td>integer</td><td>true</td><td>Number of till accounts to return per page</td></tr><tr><td><code>SortColumn</code></td><td>string</td><td>true</td><td>Field to sort results by (e.g. DateCreated)</td></tr><tr><td><code>Direction</code></td><td>string</td><td>true</td><td>Sort order — asc (ascending) or desc (descending)</td></tr></tbody></table>

**Body**

| Name                     | Data Type | Description                                            |
| ------------------------ | --------- | ------------------------------------------------------ |
| `id`                     | string    | Unique identifier of the till account                  |
| `dateCreated`            | string    | Date and time the till account was created             |
| `dateLastModified`       | string    | Date and time the till account was last updated        |
| `branchName`             | string    | Name of the branch the till belongs to                 |
| `branchCode`             | string    | Code of the branch the till belongs to                 |
| `accountNumber`          | string    | Account number linked to the till                      |
| `currencyCode`           | string    | Currency the till operates in                          |
| `accountName`            | string    | Name on the till account                               |
| `tellerUserID`           | string    | Unique ID of the teller currently assigned to the till |
| `tellerName`             | string    | Name of the assigned teller                            |
| `tellerPhoneNumber`      | string    | Phone number of the assigned teller                    |
| `requireCashVolumeLimit` | boolean   | Whether a cash volume limit is enforced on this till   |
| `cashVolumeLimit`        | number    | The configured cash volume limit, if enforced          |
| `minThresholdForAlert`   | number    | Minimum cash balance that triggers a low-balance alert |
| `maxBalance`             | number    | Maximum cash balance allowed on the till               |
| `supervisorEmail`        | string    | Email address of the till's supervisor                 |
| `recordCount`            | number    | Total number of till accounts returned                 |

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/SearchTillAccounts' \
--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": {
    "data": [
      {
        "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
        "dateCreated": "2024-09-14T22:47:57.242Z",
        "dateLastModified": "2024-09-14T22:47:57.242Z",
        "branchName": "string",
        "branchCode": "string",
        "accountNumber": "string",
        "currencyCode": "string",
        "accountName": "string",
        "tellerUserID": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
        "tellerName": "string",
        "tellerPhoneNumber": "09039413344",
        "requireCashVolumeLimit": true,
        "cashVolumeLimit": 0,
        "minThresholdForAlert": 0,
        "maxBalance": 0,
        "supervisorEmail": "string"
      }
    ],
    "recordCount": 0
  }
}
```

</details>