# Get entity records

> Lists all the entity records.

Lists all the entity records.

## API endpoint

`GET` `BaseURL/EntityService/<Entity>/read`

* Depending on the cloud platform you are using, use the associated [Base URL](https://docs.uipath.com/data-service/automation-cloud/latest/api-guide/base-url).

## Request headers

| Header | Value |
| --- | --- |
| **Authorization** | Bearer `<access_token>` |

:::note
Replace all the values between the angle brackets `<...>` with their corresponding use-case values.

The `<access_token>` is the one you received when you authorized the external application. It is available for 1 hour, then you need to generate a new one, or request a refresh token.
:::

## Query parameters

| Query parameter | Data type | Description | Default value |
| --- | --- | --- | --- |
| **start** (optional) | `int32` | Specifies the number of records to skip before retrieving the records from the query. Can be used together with the **limit** parameter to implement pagination. The records are ordered ascendingly by their IDs. | 0 |
| **limit** (optional) | `int32` | Specifies the maximum number of records to be read from the entity. Can be used together with the **start** parameter to implement pagination. The maximum value is 1000. | 100 |
| **expansionLevel** (optional) | `int32` | Specifies the depth of the related records to be retrieved. The value of this parameter can be 1, 2, or 3. | 2 |

## Responses

### 200 OK

```
{
  "TotalRecordCount": 0,
  "Value": [
    {
      "ClosingDate": "2021-03-04",
      "CreatedBy": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
      "CreateTime": "2021-03-04T10:20:47.791Z",
      "Id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
      "Logo": {
        "Name": "string",
        "Path": "string",
        "Size": 0,
        "Type": "string"
      },
      "Name": "string",
      "Nations": 0,
      "OlymipcsVersion": 0,
      "OpeningDate": "2021-03-04",
      "UpdatedBy": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
      "UpdateTime": "2021-03-04T10:20:47.791Z"
    }
  ]
}
```

### 401 Unauthorized

You are not authenticated to access Data Fabric / Data Service. Make sure your Assistant or Robot is connected to a modern folder in your account.

### 403 Forbidden

You don't have permission to access the entity, field or record or you are using an unsupported robot type. Please contact your administrator for necessary permissions.