---
title: "List contact snapshots"
method: GET
path: "/object-query/contact-snapshots"
tags: ["Object Queries"]
---

# List contact snapshots

`GET /object-query/contact-snapshots`

Lists contact snapshots. You can use the query parameters to filter, expand, and sort the returned results.

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

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