---
search:
  tags:
    - Objects and records
    - GET
seo:
  description: >-
    A page of records. Four combinations are refused with 400 and… Reference for
    the GET /api/v1/objects/{objectId}/records endpoint in the Taylorz CRM API.
sidebar:
  label: List an object's records
  badge: GET
title: List an object's records
type: openapi-operation
---
A page of records. Four combinations are refused with `400` and cannot be expressed in the parameter list: `via` requires `relatedTo`; `orderBy` cannot be combined with `view`; `cursor` requires one of them; and `after` cannot be combined with either, so page an ordered query with `cursor`. A cursor positions rows only within the ordering that produced it.

`GET /api/v1/objects/{objectId}/records`

**Responses**

- `200` — A page of records
- `400` — The request body, query or parameters were refused
- `401` — The access token is missing, invalid or revoked
- `403` — The tenant's module is off, or the token's scope or the member's role does not permit the action
- `404` — No such record, or none the caller may read
- `413` — The request exceeds the route's body limit
- `500` — An unexpected failure

Response example, 200:

```json
{
  "items": [
    {
      "archivedAt": "2019-08-24T14:15:22Z",
      "createdAt": "2019-08-24T14:15:22Z",
      "id": "string",
      "name": "string",
      "objectId": "string",
      "revision": 1,
      "updatedAt": "2019-08-24T14:15:22Z",
      "values": {
        "property1": "string",
        "property2": "string"
      },
      "relations": {
        "property1": [
          {
            "archived": true,
            "id": "string",
            "name": "string"
          }
        ],
        "property2": [
          {
            "archived": true,
            "id": "string",
            "name": "string"
          }
        ]
      }
    }
  ],
  "nextCursor": "string",
  "total": -9007199254740991
}
```