# Get All Robot Accounts

> API reference for retrieving the complete list of robot accounts from an organization using the GET RobotAccount endpoint.

Returns the list of all robot accounts from an organization, based on the organization ID.

## API Endpoint

`GET` `https://{yourDomain}/identity/api/RobotAccount`

## Scopes

Requires the following scopes:

* PM.RobotAccount
* PM.RobotAccount.Read

## Request Headers

```
--header 'Authorization: Bearer {access_token}'\
--header 'Content-Type: application/json'
```

:::note
To obtain the `{access_token}`, make sure to authenticate through one of the methods described [here](https://docs.uipath.com/orchestrator/standalone/2023.10/api-guide/authentication-methods#authentication-methods).
:::

## Path Parameters

| Path param | Data type | Description |
| --- | --- | --- |
| `partitionGlobalId`  (required) | String | The ID of the organization you want to retrieve the robot accounts for. |

## Query Parameters

| Query param | Data type | Description |
| --- | --- | --- |
| `searchTerm`  (optional) | String | The key you want to search the robot accounts after. |
| `top`  (optional) | int32 | Display the top N robot accounts. |
| `skip`  (optional) | int32 | Skip the top N robot accounts. |
| `sortBy`  (optional) | int32 | Specify the DTO property used to sort audit entries by.  For example, `name`, `creationTime`, `id`, etc. |
| `sortOrder`  (optional) | int32 | Specify the sorting order.  For example, ascending (`asc`) or descending (`desc`). |

## Responses

### 200 OK

Returns the queried robot accounts.

## Example Request

Let's say you gathered all the information needed to build the API call.

* Your `{baseURL}` is: https://{yourDomain}/identity
* Your `{access_token}` is: `1234` (for length considerations).
* The `{partitionGlobalId}` is: `3fa85f64-5717-4562-b3fc-2c963f66afa6`
* You set the following query params:
  + `searchTerm` = `bot`
  + `top` = 2, to display the top two entries
  + `skip` = 2, to skip the first two entries
  + `sortBy` = `name`, to sort the entries by their name
  + `sortOrder` = `asc`, to sort the entries from the earliest entry to the latest one

The call should resemble the following example (cURL):

```
curl --location --request GET 'https://{yourDomain}/identity/api/RobotAccount/3fa85f64-5717-4562-b3fc-2c963f66afa6?searchTerm=attended&top=2&skip=2&sortBy=name&sortOrder=asc' \
--header 'Authorization: Bearer 1234' \
--header 'Content-Type: application/json'
```

Here's the response body for a successful audit entries retrieval:

```
{
    "totalCount": 3,
    "results": [
        {
            "id": "55-ab",
            "name": "Bot5",
            "displayName": "Bot5",
            "creationTime": "2021-10-19T18:05:17.3465735",
            "lastLoginTime": null,
            "groupIds": [
                "group1",
                "group2",
                "group3"
            ]
        },
        {
            "id": "66-cd",
            "name": "Bot6",
            "displayName": "Bot6",
            "creationTime": "2021-10-19T18:06:00.3088553",
            "lastLoginTime": null,
            "groupIds": [
                "group1",
                "group3"
            ]
        },
        {
            "id": "77-ef",
            "name": "Bot7",
            "displayName": "Bot7",
            "creationTime": "2021-10-19T18:05:31.4736281",
            "lastLoginTime": null,
            "groupIds": [
                "group2"
            ]
        }
    ]
}
```