---
title: "List proofs"
method: GET
path: "/sheets/{sheetId}/proofs"
tags: ["proofs"]
---

# List proofs

`GET /sheets/{sheetId}/proofs`

Gets a list of all proofs for a given sheet.

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

## Query parameters

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

## Response `200`

OK.

**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` Proof[] — list of all proofs
    - `id` number — Proof ID of the proof version.
    - `originalId` number — Proof ID of the original proof version.
    - `name` string — Proof name. This is the same as primary column value. If the primary column value is empty, name is empty.
    - `type` 'DOCUMENT' | 'IMAGE' | 'MIXED' | 'NONE' | 'VIDEO' — File type for the proof version.
    - `documentType` string — If `type=DOCUMENT`, then this indicates the type of file, such as PDF.
    - `proofRequestUrl` string — URL to review a proofing request.
    - `version` number — The version number of the proof.
    - `lastUpdatedAt` union
      - string, date-time
      - number
    - `lastUpdatedBy` MiniUser — MiniUser Object
      - `email` string, email
      - `name` string
    - `isCompleted` boolean — Indicates whether the proof is completed.
    - `attachments` Attachment[] — Array of Attachment objects. Only returned if the include query string parameter contains attachments.
      - `id` number — Attachment ID.
      - `parentId` number — The ID of the parent.
      - `attachmentType` 'BOX_COM' | 'DROPBOX' | 'EGNYTE' | 'EVERNOTE' | 'FILE' | 'GOOGLE_DRIVE' | 'LINK' | 'ONEDRIVE' | 'TRELLO' — Attachment type. Note--Dropbox, Egnyte, and Evernote are not supported for Smartsheet.gov accounts.
      - `attachmentSubType` 'DOCUMENT' | 'DRAWING' | 'FOLDER' | 'PDF' | 'PRESENTATION' | 'SPREADSHEET' — Attachment sub type. Note--Folder type is for EGNYTE values and the rest are GOOGLE_DRIVE values.
      - `mimeType` string — Attachment MIME type.
      - `parentType` 'COMMENT' | 'PROOF' | 'ROW' | 'SHEET' — The type of object the attachment belongs to.
      - `createdAt` union
        - string, date-time
        - number
      - `createdBy` MiniUser — MiniUser Object
        - `email` string, email
        - `name` string
      - `name` string — Attachment name.
      - `sizeInKb` number — The size of the file, if the attachmentType is FILE.
      - `url` string — Attachment temporary URL (files only).
      - `urlExpiresInMillis` number — Attachment temporary URL time to live (files only).
    - `discussions` Discussion[] — Array of Discussion objects. Only returned if the include query string parameter contains discussions.
      - `accessLevel` 'ADMIN' | 'COMMENTER' | 'EDITOR' | 'EDITOR_SHARE' | 'OWNER' | 'VIEWER'
      - `id` number — Discussion ID.
      - `comments` Comment[] — Array of comments in discussion. Only returned if the include query string parameter contains comments.
        - `attachments` Attachment[] — Array of attachments on comments.
          - `id` number — Attachment ID.
          - `parentId` number — The ID of the parent.
          - `attachmentType` 'BOX_COM' | 'DROPBOX' | 'EGNYTE' | 'EVERNOTE' | 'FILE' | 'GOOGLE_DRIVE' | 'LINK' | 'ONEDRIVE' | 'TRELLO' — Attachment type. Note--Dropbox, Egnyte, and Evernote are not supported for Smartsheet.gov accounts.
          - `attachmentSubType` 'DOCUMENT' | 'DRAWING' | 'FOLDER' | 'PDF' | 'PRESENTATION' | 'SPREADSHEET' — Attachment sub type. Note--Folder type is for EGNYTE values and the rest are GOOGLE_DRIVE values.
          - `mimeType` string — Attachment MIME type.
          - `parentType` 'COMMENT' | 'PROOF' | 'ROW' | 'SHEET' — The type of object the attachment belongs to.
          - `createdAt` union
            - string, date-time
            - number
          - `createdBy` MiniUser — MiniUser Object
            - `email` string, email
            - `name` string
          - `name` string — Attachment name.
          - `sizeInKb` number — The size of the file, if the attachmentType is FILE.
          - `url` string — Attachment temporary URL (files only).
          - `urlExpiresInMillis` number — Attachment temporary URL time to live (files only).
        - `createdAt` union
          - string, date-time
          - number
        - `createdBy` MiniUser — MiniUser Object
          - `email` string, email
          - `name` string
        - `discussionId` number — Discussion ID of discussion that contains comment.
        - `id` number — Comment ID.
        - `modifiedAt` union
          - string, date-time
          - number
        - `text` string — Comment body.
      - `commentAttachments` Attachment[] — Array of attachments on discussion comments. Only returned if the include query string parameter contains attachments.
        - `id` number — Attachment ID.
        - `parentId` number — The ID of the parent.
        - `attachmentType` 'BOX_COM' | 'DROPBOX' | 'EGNYTE' | 'EVERNOTE' | 'FILE' | 'GOOGLE_DRIVE' | 'LINK' | 'ONEDRIVE' | 'TRELLO' — Attachment type. Note--Dropbox, Egnyte, and Evernote are not supported for Smartsheet.gov accounts.
        - `attachmentSubType` 'DOCUMENT' | 'DRAWING' | 'FOLDER' | 'PDF' | 'PRESENTATION' | 'SPREADSHEET' — Attachment sub type. Note--Folder type is for EGNYTE values and the rest are GOOGLE_DRIVE values.
        - `mimeType` string — Attachment MIME type.
        - `parentType` 'COMMENT' | 'PROOF' | 'ROW' | 'SHEET' — The type of object the attachment belongs to.
        - `createdAt` union
          - string, date-time
          - number
        - `createdBy` MiniUser — MiniUser Object
          - `email` string, email
          - `name` string
        - `name` string — Attachment name.
        - `sizeInKb` number — The size of the file, if the attachmentType is FILE.
        - `url` string — Attachment temporary URL (files only).
        - `urlExpiresInMillis` number — Attachment temporary URL time to live (files only).
      - `commentCount` number — Number of comments in the discussion.
      - `createdBy` MiniUser — MiniUser Object
        - `email` string, email
        - `name` string
      - `lastCommentedAt` union
        - string, date-time
        - number
      - `lastCommentedUser` MiniUser — MiniUser Object
        - `email` string, email
        - `name` string
      - `parentId` number — The ID of the associated row or sheet.
      - `parentType` 'ROW' | 'SHEET' — Type of parent object.
      - `readOnly` boolean — Indicates whether the user can modify the discussion.
      - `title` string — Title automatically created by duplicating the first 100 characters of top-level comment.

---

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