---
title: "GET /documents/{document_id}"
method: GET
path: "/documents/{document_id}"
tags: ["Document"]
---

# GET /documents/{document_id}

`GET /documents/{document_id}`

## Request

- Base URL: `https://api-docs.simplepdf.com/api/v1`
- URL: `https://api-docs.simplepdf.com/api/v1/documents/{document_id}`
- Auth: HTTP bearer

Retrieve a specific document. Returns a short-lived presigned `url` to download the original PDF, the public `embed_url` a recipient opens to fill and submit (standalone or embedded; append `?prefill=<id>` to apply a prefill), and a single-use, document-scoped `dashboard_url` granting an admin editor session.

## Path parameters

- `document_id` string, uuid, required

## Response `200`

Successful response

- object
  - `id` string, required
  - `name` string, required
  - `type` union, required: edit_and_submit: fields can be positioned and modified before submitting. submit: fields cannot be changed nor edited.
    - 'edit_and_submit'
    - 'submit'
  - `embed_url` string, required: Public link a recipient opens to fill and submit the document in the SimplePDF editor, standalone or embedded in an iframe. No expiry; anyone with the link can use it. Append `?prefill=<prefill_id>` to apply a prefill.
  - `created_at` string, required
  - `updated_at` string, required
  - `url` string, required: Short-lived presigned URL to download the original document PDF (the uploaded file, not a submission). Expires shortly after issue; fetch a fresh one per use.
  - `dashboard_url` string, required: Single-use, document-scoped URL granting an embeddable admin editor session bound to this document. Mint a fresh URL for each load.
  - `created_by` union, required: Who created the document: `company_user` (an organization member; `details.id` is their user id) or `external_party` (created anonymously through a public link or embed editor; `details` is `null`). The whole field is `null` when the creator was not recorded.
    - object
      - `type` 'company_user', required
      - `details` object, required
        - `id` string, required
    - object
      - `type` 'external_party', required
      - `details` unknown, required

## Other responses

- `400`: Bad request
- `401`: Unauthorized
- `404`: Not found
- `429`: Too many requests

---

[API](https://skmtc.dev/simplepdf/apis/simplepdf-api.md) · [All operations](https://skmtc.dev/simplepdf/apis/simplepdf-api/llms.txt) · [OpenAPI document](https://skmtc.dev/simplepdf/apis/simplepdf-api/revisions/0bc3915e908d?raw)