> ## 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.

# Browse object records

> Browse active records from an object with display-ready attribute previews.

Browse active records from an object with display-ready attribute previews.

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

Required scopes: `objects:read`, `records:read`.

Unknown objects return `404`; malformed cursors return `400`. Results include previews rather than the full writable record values map. Non-Pro workspaces omit enriched and Pro interaction attributes.

## Parameters

<ParamField path="objectSlug" type="string" required>
  The object’s slug, not its ID.
</ParamField>

<ParamField query="q" type="string">
  Optional trimmed title search, up to 200 characters.
</ParamField>

<ParamField query="cursor" type="string">
  Opaque nextCursor returned by this Raycast collection; do not use a developer API cursor.
</ParamField>

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

## Response

**200** — Top-level `object`, `data` [record previews](/api-reference/raycast/models#record-previews), `hasMore`, and `nextCursor`.

<ResponseExample>
  ```json 200 theme={null}
  {
    "object": {
      "id": "object_example",
      "name": "Clients",
      "singularName": "Client",
      "pluralName": "Clients",
      "slug": "clients",
      "icon": null,
      "color": null,
      "description": 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": []
        }
      }
    ],
    "hasMore": false,
    "nextCursor": null
  }
  ```
</ResponseExample>

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

Set path-ID environment variables to values returned by your workspace before running the request.


## Related topics

- [All endpoints](/api-reference/endpoints.md)
- [Objects and records API](/api-reference/objects-and-records.md)
- [Choose what to track](/documentation/data/objects.md)
- [Raycast](/integrations/raycast.md)
- [Developer quickstart](/api-reference/quickstart.md)