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

# Get proof

`GET /sheets/{sheetId}/proofs/{proofId}`

Gets the proof specified in the URL. Returns the proof, which is optionally populated with discussion and attachment objects.

## Query parameters

- `include` 'attachments' | 'discussions'

## Response `200`

SUCCESS

- Proof — Object containing zero or more media items, including images, videos, and documents, for review, editing, or approval.
  - `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)