---
title: "List objects in a collection"
method: GET
path: "/v1/objects/{collection}"
tags: ["Objects"]
---

# List objects in a collection

`GET /v1/objects/{collection}`

Returns a paginated list of objects from the specified collection. Optionally includes preference data for the objects.

## Path parameters

- `collection` string, required

## Query parameters

- `after` string
- `before` string
- `page_size` integer
- `include[]` string[]

## Response `200`

OK

- ListObjectsResponse — A paginated list of objects in a collection.
  - `entries` Object[], required — A list of objects.
    - `__typename` string, required — The typename of the schema.
    - `collection` string, required — The collection this object belongs to.
    - `created_at` string, date-time, nullable — Timestamp when the resource was created.
    - `id` string, required — Unique identifier for the object.
    - `properties` object — The custom properties associated with the object.
    - `updated_at` string, date-time, required — The timestamp when the resource was last updated.
  - `page_info` PageInfo, required — Pagination information for a list of resources.
    - `__typename` string, required — The typename of the schema.
    - `after` string, nullable — The cursor to fetch entries after.
    - `before` string, nullable — The cursor to fetch entries before.
    - `page_size` integer, required — The number of items per page (defaults to 50).

## Changes

- **2025-05-19** `923618cb1489` — 1 info
  - added the optional property `entries/items/properties` to the response with the `200` status

[Change history](https://skmtc.dev/knocklabs/apis/knock-api/changes/v1/objects/:collection/get.md)

---

[API](https://skmtc.dev/knocklabs/apis/knock-api.md) · [All operations](https://skmtc.dev/knocklabs/apis/knock-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/knocklabs/knock-api/revisions/4b8499dddbc5/schema)