---
title: "List records for a custom object"
method: GET
path: "/objects/records/default/{object}"
tags: ["Custom Object Records"]
---

# List records for a custom object

`GET /objects/records/default/{object}`

Lists all object records of the given type. You can also use the `q` query parameter to filter the output records.


### Custom Objects read consistency

Custom Objects support eventually consistency. When you read custom object records, the response might not reflect the result of a recently completed operation and might include some stale data. The operations include creating, updating, and deleting custom object records.  If you repeat your read request after a short time, the response should return the latest data.

For example, if you create five records and perform a query that these five records satisfy the query conditions, there might be a delay before these records can be returned in the query result.

## Path parameters

- `object` string, required

## Query parameters

- `q` string
- `ids` string
- `pageSize` integer
- `cursor` string

## Headers

- `Accept-Encoding` string
- `Content-Encoding` string
- `Zuora-Track-Id` string
- `Zuora-Entity-Ids` string
- `Zuora-Org-Ids` string
- `Zuora-Version` string, date

## Response `200`

OK

- QueryCustomObjectRecordsResponse
  - `count` integer, required — The record count of the given custom object type
  - `records` CustomObjectRecordWithAllFields[], required
    - `CreatedById` string — The creator's Id
    - `CreatedDate` string, date-time — The record creation time in the date-time format
    - `Id` string, uuid — The unique Id of the custom object record
    - `UpdatedById` string — The modifier's Id
    - `UpdatedDate` string, date-time — The record modification time in the date-time format
    - `type` string — The type of the custom object record. It is the API name of the custom object definition.

---

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