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

---

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