---
title: "Retrieve a contact snapshot"
method: GET
path: "/object-query/contact-snapshots/{key}"
tags: ["Object Queries"]
---

# Retrieve a contact snapshot

`GET /object-query/contact-snapshots/{key}`

Retrieves detailed information about a specific contact snapshot by its unique ID.

## Path parameters

- `key` string, required

## Query parameters

- `pageSize` integer
- `cursor` string
- `sort[]` 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

- ExpandedContactSnapshot
  - `id` string — The unique identifier of the contact snapshot.
  - `createdById` string — The unique identifier of the user who created the snapshot.
  - `createdDate` string, date-time — The date and time when the contact snapshot was created.
  - `updatedById` string — The unique identifier of the user who last updated the snapshot.
  - `updatedDate` string, date-time — The date and time when the contact snapshot was last updated.
  - `accountId` string — The unique identifier of the associated billing account.
  - `contactId` string — The unique identifier of the original contact.
  - `firstName` string — The first name of the contact.
  - `lastName` string — The last name of the contact.
  - `nickName` string — The nickname of the contact.
  - `address1` string — The first line of the address.
  - `address2` string — The second line of the address.
  - `city` string — The city of the contact's address.
  - `state` string — The state or province of the contact's address.
  - `postalCode` string — The postal or ZIP code.
  - `county` string — The county or region of the contact.
  - `country` string — The county or region of the contact.
  - `taxRegion` string — The tax region applicable to the contact.
  - `description` string — The free-form description of the contact snapshot.
  - `homePhone` string — The home phone number.
  - `otherPhone` string — Any other phone number.
  - `otherPhoneType` string — The type of the other phone number.
  - `fax` string — The fax number.
  - `personalEmail` string — The personal email address.
  - `workEmail` string — The personal email address.
  - `deleted` boolean — Indicates whether the contact snapshot is marked as deleted.

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