---
title: "List contacts"
method: GET
path: "/contacts"
tags: ["contacts"]
---

# List contacts

`GET /contacts`

Gets a list of the user's Smartsheet contacts.

> **Note:** For pagination guidance, refer to [Pagination](/api/smartsheet/guides/basics/pagination).

## Query parameters

- `includeAll` boolean
- `modifiedSince` union
  - string, date-time
  - number
- `numericDates` boolean
- `page` number
- `pageSize` number

## Response `200`

IndexResult object containing an array of Contact objects.

**Note:** For pagination guidance, refer to [Pagination](/api/smartsheet/guides/basics/pagination).

- object
  - `pageNumber` number — The current page in the full result set that the data array represents. NOTE when a page number greater than totalPages is requested, the last page is instead returned.
  - `pageSize` number, nullable — The number of items in a page. Omitted if there is no limit to page size (and hence, all results are included). Unless otherwise specified, this defaults to 100 for most endpoints.
  - `totalPages` number — The total number of pages in the full result set.
  - `totalCount` number — The total number of items in the full result set.
  - `data` Contact[] — List of Contacts
    - `id` string — Contact ID.
    - `name` string — Contact's full name.
    - `email` string, email — Contact's email address.

## Other responses

- `401` — Unauthorized. See Smartsheet Error Code and Message for details.
- `404` — Not Found. See Smartsheet Error Code and Message for details.
- `500` — Internal Server Error. See Smartsheet Error Code and Message for details.

---

[API](https://skmtc.net/smartsheet/apis/smartsheet-openapi-reference.md) · [All operations](https://skmtc.net/smartsheet/apis/smartsheet-openapi-reference/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/smartsheet/smartsheet-openapi-reference/versions/b4afda95fb51/schema)