> ## Documentation Index
> Fetch the complete documentation index at: https://docs.getkato.io/llms.txt
> Use this file to discover all available pages before exploring further.

# List records

> Page through workspace records, optionally filtered to an object.

Page through workspace records, optionally filtered to an object.

Use a developer access key. See [authentication, errors, and rate limits](/api-reference/authentication).

Required scopes: `records:read`.

Records are ordered by creation time descending, then ID descending. Unknown objects return `404`; malformed cursors return `400`. Pass `next_cursor` unchanged to continue.

## Parameters

<ParamField query="object" type="string">
  Object ID or slug. Omit to include records across objects.
</ParamField>

<ParamField query="cursor" type="string">
  Opaque cursor from the preceding page.
</ParamField>

<ParamField query="limit" type="integer">
  Default 25, maximum 100. Positive numeric inputs are floored; invalid or nonpositive inputs use the default.
</ParamField>

<ParamField query="include_archived" type="string">
  `true` includes archived items; `false` is the default.
</ParamField>

## Response

**200** — `data` contains records; `has_more` indicates another page and `next_cursor` is null at the end. See [record response fields](/api-reference/objects-and-records#list-and-retrieve).

<ResponseExample>
  ```json 200 theme={null}
  {
    "data": [
      {
        "id": "record_example",
        "objectTypeId": "object_example",
        "title": "Northlane",
        "avatarUrl": null,
        "values": {
          "field_name": "Northlane"
        },
        "archived": false,
        "createdBy": "user_example",
        "createdAt": "2026-09-07T12:00:00.000Z",
        "updatedAt": "2026-09-07T12:00:00.000Z"
      }
    ],
    "has_more": false,
    "next_cursor": null
  }
  ```
</ResponseExample>

<RequestExample>
  ```bash Request theme={null}
  curl --fail-with-body --silent --show-error --get \
    "https://api.getkato.io/v1/records" \
    -H "Authorization: Bearer $KATO_API_KEY" \
    --data-urlencode "limit=25"
  ```
</RequestExample>


## Related topics

- [All endpoints](/api-reference/endpoints.md)
- [List recent records](/api-reference/raycast/records-recent.md)
- [List objects](/api-reference/objects/list.md)
- [List object fields](/api-reference/objects/fields.md)
- [List CLI projects](/api-reference/cli/projects.md)