> 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/account/editor/search-account-officer.md).

# Search Account Officer

To retrieve the list of account officers, make a GET request to this endpoint, no parameters need to be passed.

A successful request returns an array of account officers under `data`, each including their `name`, `staffID`, `branchName`, and `status`, along with a `recordCount` showing the total number returned.

This process allows you to view every account officer registered on the platform, useful when assigning an officer to a new account.

<mark style="color:blue;">`GET`</mark> `/api/account/v1/SearchAccountOfficers`

**Headers**

| Name                                                | Value                |
| --------------------------------------------------- | -------------------- |
| Content-Type<mark style="color:red;">\*</mark>      | `application/json`   |
| Authorization<mark style="color:red;">\*</mark>     | `bearer <token>`     |
| Request-reference<mark style="color:red;">\*</mark> | `{unique_reference}` |

This endpoint takes no query parameters.

**Body**

| Name             | Data Type | Description                                  |
| ---------------- | --------- | -------------------------------------------- |
| `id`             | string    | Unique ID of the account officer             |
| `name`           | string    | Full name of the account officer             |
| `gender`         | string    | Gender of the account officer                |
| `branchCode`     | string    | Code of the officer's branch                 |
| `branchName`     | string    | Name of the officer's branch                 |
| `staffID`        | string    | Staff ID of the account officer              |
| `phoneNumber`    | string    | Phone number of the account officer          |
| `address`        | string    | Address of the account officer               |
| `status`         | string    | Current status of the account officer        |
| `accessLevel`    | number    | Access level assigned to the officer         |
| `dateCreated`    | string    | Date the officer record was created          |
| `linkedUser`     | string    | User account linked to the officer           |
| `supervisor`     | string    | Email/identifier of the officer's supervisor |
| `supervisorName` | string    | Name of the officer's supervisor             |
| `recordCount`    | number    | Total number of account officers returned    |

**Sample API Request**

{% tabs %}
{% tab title="Curl" %}

```javascript
curl --location -g '{{baseurl}}/api/account/v1/SearchAccountOfficers' \
--header 'Authorization: bearer {token}' \
--header 'request-reference: {unique_reference}' \
--header 'Content-Type: application/json' \
--data ''
```

{% endtab %}
{% endtabs %}

**Response**

{% tabs %}
{% tab title="json" %}
{% code expandable="true" %}

```json
{
  "status": true,
  "message": "string",
  "data": {
    "data": [
      {
        "id": "string",
        "name": "string",
        "gender": "string",
        "branchCode": "string",
        "branchName": "string",
        "staffID": "string",
        "phoneNumber": "string",
        "address": "string",
        "status": "string",
        "accessLevel": "long",
        "dateCreated": "string",
        "linkedUser": "string",
        "supervisor": "string",
        "supervisorName": "string"
      }
    ],
    "recordCount": "long"
  }
}
```

{% endcode %}
{% endtab %}
{% endtabs %}

{% hint style="info" %}
`data.data` returns one entry per account officer. `recordCount` shows the total number of officers returned.
{% endhint %}