> ## 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 recent records

> Read recently updated active records across workspace objects.

Read recently updated active records across workspace objects.

Use an OAuth access token issued to `kato-raycast`. Developer keys cannot call this endpoint. See [Raycast authentication](/api-reference/raycast/overview).

Required scopes: `records:read`.

Ordered by update time descending, without pagination. Each record has up to eight attribute previews. Managed enrichment and Pro interaction previews are omitted for non-Pro workspaces.

## Parameters

<ParamField query="limit" type="integer">
  Default 20; 1–50.
</ParamField>

## Response

**200** — Returns the resource under `data`. Example IDs and values are illustrative.

<ResponseExample>
  ```json 200 theme={null}
  {
    "data": [
      {
        "kind": "record",
        "id": "record_example",
        "title": "Northlane",
        "subtitle": "Client",
        "badge": "Client",
        "avatarUrl": null,
        "webUrl": "https://app.getkato.io/northlane/o/clients/record_example",
        "record": {
          "objectTypeSlug": "clients",
          "objectTypeName": "Client",
          "icon": null,
          "color": null,
          "meta": []
        }
      }
    ]
  }
  ```
</ResponseExample>

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


## Related topics

- [All endpoints](/api-reference/endpoints.md)
- [List records](/api-reference/records/list.md)
- [Vercel](/integrations/vercel.md)
- [List objects](/api-reference/objects/list.md)
- [Convex](/integrations/convex.md)