Retrieve a document

​

Retrieves one document by the id that POST /public-api/v1/docs or GET /public-api/v1/docs returned, in the same shape both of them use.

Read it again after the user acts in Bonsai to see where the document stands: its status, how far each recipient has got, and which roles are still unassigned. Signing links are never included.

A document the token cannot see returns 404, and so does the id of a template: templates are not documents.

Path Parameters

  • id
    Type: integer
    required

    The document's id.

Responses

  • application/json
  • application/json
  • application/json
  • application/json
Request Example for get/public-api/v1/docs/{id}
curl https://app.hellobonsai.com/public-api/v1/docs/1 \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN'

{
  "data": {
    "id": 5120,
    "title": "Web Design Proposal - Acme Corp",
    "doc_number": "DOC-42",
    "deal_id": 918,
    "created_at": "2026-04-14T09:12:04.000Z",
    "updated_at": "2026-04-14T09:12:04.000Z",
    "status": "draft",
    "project_ids": [
      1203
    ],
    "recipients": [
      {
        "status": "pending",
        "role": {
          "name": "Receiver",
          "kind": "receiver"
        },
        "contact_id": 7,
        "company_member_id": 314,
        "company_id": 42,
        "name": "Jane Cooper",
        "email": "jane@acme.test"
      }
    ],
    "unassigned_roles": [
      {
        "name": "Receiver",
        "kind": "receiver"
      }
    ],
    "url": "https://app.hellobonsai.com/docs/b3c1f0a9d2e4"
  },
  "meta": {
    "request_id": "b1f0d2c4-7a9e-4c3b-8d5f-1e2a3b4c5d6e"
  }
}

The document.