---
title: "View public document"
method: GET
path: "/v1/public/documents/{documentId}"
tags: ["Signing"]
---

# View public document

`GET /v1/public/documents/{documentId}`

Retrieve a publicly shared document by ID. Public endpoint.

[Copy as Markdown](https://api.assinafy.com.br/v1/docs/markdown?method=get&path=%2Fv1%2Fpublic%2Fdocuments%2F%7BdocumentId%7D) [Open in ChatGPT](https://chatgpt.com/?q=Read%20the%20API%20documentation%20at%20https%3A%2F%2Fapi.assinafy.com.br%2Fv1%2Fdocs%2Fmarkdown%3Fmethod%3Dget%26path%3D%252Fv1%252Fpublic%252Fdocuments%252F%257BdocumentId%257D%20and%20help%20me%20integrate%20this%20endpoint.) [Open in Claude](https://claude.ai/new?q=Read%20the%20API%20documentation%20at%20https%3A%2F%2Fapi.assinafy.com.br%2Fv1%2Fdocs%2Fmarkdown%3Fmethod%3Dget%26path%3D%252Fv1%252Fpublic%252Fdocuments%252F%257BdocumentId%257D%20and%20help%20me%20integrate%20this%20endpoint.)

## Path parameters

- `documentId` string, required

## Response `200`

The public document

- object — Standard success wrapper. Operations add their own `data`.
  - `status` integer — HTTP status code, mirrored in the body.
  - `message` string — Human-readable message; empty on success.
  - `data` Document — A document and its current lifecycle state.
    - `resource` string — Present in single-resource responses.
    - `id` string
    - `account_id` string
    - `template_id` string, nullable
    - `name` string
    - `status` string — Status code — see GET /v1/documents/statuses.
    - `artifacts` object — Artifact download URLs keyed by name (original, certificated, certificate-page, bundle).
    - `is_closed` boolean
    - `signing_url` string
    - `decline_reason` string, nullable
    - `declined_by` Signer — A signing party belonging to a workspace account.
      - `resource` string — Present in single-resource responses.
      - `id` string
      - `full_name` string
      - `email` string, email, nullable
      - `whatsapp_phone_number` string, nullable — E.164 format; normalized on save.
      - `has_accepted_terms` boolean
    - `tags` object[]
      - `id` string
      - `name` string
    - `assignment` Assignment — A request for signers to sign a document.
      - `resource` string
      - `id` string
      - `sender_email` string, email
      - `method` 'virtual' | 'collect'
      - `expires_at` string, date-time, nullable
      - `message` string, nullable
      - `signers` AssignmentSigner[]
        - `resource` string — Present in single-resource responses.
        - `id` string
        - `full_name` string
        - `email` string, email, nullable
        - `whatsapp_phone_number` string, nullable — E.164 format; normalized on save.
        - `has_accepted_terms` boolean
        - `verification_method` string, nullable
        - `notification_methods` string[], nullable
        - `step` integer, nullable — Sequential signing step (defaults to 1).
        - `notified` boolean, nullable
        - `completed` boolean, nullable — Only present in account-owner contexts.
        - `notification_history` NotificationHistoryEntry[], nullable — Per-channel delivery history for this signer (email + WhatsApp), most-recent send order.
          - `event` string
          - `status` 'sent' | 'failed'
          - `error_code` string, nullable
          - `error_message` string, nullable
          - `sent_at` string, date-time, nullable
          - `failed_at` string, date-time, nullable
      - `copy_receivers` object[]
      - `items` AssignmentItem[]
        - `id` string
        - `page` DocumentPage
          - `id` string
          - `number` integer
          - `height` integer
          - `width` integer
          - `download_url` string
        - `signer` object — Signer responsible for this item.
        - `field` object, nullable — Field definition associated with the item.
        - `display_settings` unknown
        - `value` unknown
        - `completed` boolean
      - `summary` AssignmentSummary
        - `signer_count` integer
        - `completed_count` integer
        - `signers` object[]
      - `signing_urls` SigningUrl[]
        - `signer_id` string
        - `url` string
    - `pages` DocumentPage[]
      - `id` string
      - `number` integer
      - `height` integer
      - `width` integer
      - `download_url` string
    - `created_at` string, date-time
    - `updated_at` string, date-time

## Other responses

- `404` — The requested resource does not exist.
- `500` — Unexpected server error.

---

[API](https://skmtc.dev/assinafy/apis/assinafy-api-reference.md) · [All operations](https://skmtc.dev/assinafy/apis/assinafy-api-reference/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/assinafy/assinafy-api-reference/revisions/f479941d10e9/schema)
