---
title: "List custom object records"
method: GET
path: "/object-query/{custom-object-name}"
tags: ["Object Queries"]
---

# List custom object records

`GET /object-query/{custom-object-name}`

Lists custom object records. You can use the query parameters to filter, expand, and sort the returned results. 

The name of a custom object is in the `{namespace}__{objectname}s` format, for example, `default__cars`.

**Note**: Sorting queried custom objects by ID is not supported.

## Path parameters

- `custom-object-name` string, required

## Query parameters

- `pageSize` integer
- `cursor` string
- `expand[]` string[]
- `filter[]` string[]
- `fields[]` string[]
- `includeNullFields` boolean

## Headers

- `Idempotency-Key` string
- `Accept-Encoding` string
- `Content-Encoding` string
- `Zuora-Track-Id` string
- `Zuora-Entity-Ids` string
- `Zuora-Org-Ids` string
- `Zuora-Version` string

## Response `200`

OK

- object
  - `nextPage` string, nullable — A string that can be used as the `cursor` value to retrieve the next page of the response if it exists; otherwise absent.
  - `data` object[]

## Other responses

- `500` — Internal server error
- `4XX` — Invalid input

---

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