---
title: "Retrieve a custom object record"
method: GET
path: "/object-query/{custom-object-name}/{key}"
tags: ["Object Queries"]
---

# Retrieve a custom object record

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

Retrieve the details of a specific custom object record. 

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

## Path parameters

- `custom-object-name` string, required
- `key` 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

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