---
title: "Lists sent update requests"
method: GET
path: "/sheets/{sheetId}/sentupdaterequests"
tags: ["updateRequests"]
---

# Lists sent update requests

`GET /sheets/{sheetId}/sentupdaterequests`

Lists summarized sent update requests on the sheet.

For comprehensive details on a sent update request, refer to [Get sent update request](/api/smartsheet/openapi/updaterequests/sentupdaterequest-get).

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

## Query parameters

- `includeAll` boolean
- `page` number
- `pageSize` number

## Response `200`

Paginated list of sent update request indexes.

> **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` SentUpdateRequestListItem[] — List of sent update request indexes.
    - `id` number — The ID of the sent update request.
    - `updateRequestId` number — The ID of the originating update request.
    - `message` string — The message of the email. Max 10000 characters.
    - `sentAt` union
      - string, date-time
      - number
    - `sentBy` MiniUser — MiniUser Object
      - `email` string, email
      - `name` string
    - `sentTo` union — Specifies the recipient of an email. The recipient may be either an individual or a group. To specify an individual, set the email attribute; to specify a group, set the groupId attribute. Either email and groupId may be set, but not both.
      - RecipientIndividual — Specifies the recipient of an [Email](/api/smartsheet/openapi/schemas/email). The recipient may be either an individual or a group. To specify an individual, set the `email` attribute; to specify a group, set the `groupId` attribute. Either `email` and `groupId` may be set, but not both.
        - `email` string, email — The email address of an individual recipient.
      - RecipientGroup — Specifies the recipient of an [Email](/api/smartsheet/openapi/schemas/email). The recipient may be either an individual or a group. To specify an individual, set the `email` attribute; to specify a group, set the `groupId` attribute. Either **email** and `groupId` may be set, but not both.
        - `groupId` number — The ID of a group recipient.
    - `status` 'CANCELED' | 'COMPLETE' | 'PENDING' — The status of the sent update request.
    - `subject` string — The subject of the email.

---

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