Retrieve a document
Retrieves one document by the id that POST /public-api/v1/docs or
GET /public-api/v1/docs returned. It has the fields the list returns,
plus the document's pricing_table: its packages, their line items and
what they add up to. Totals leave out optional packages and rows, since
the client has not picked them yet.
Read it again after the user acts in Bonsai to see where the document
stands: its status and deadline, 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
- Type: integeridrequired
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,
"expiration_days": 14,
"expiration_date": "2026-04-28",
"created_at": "2026-04-14T09:12:04.000Z",
"updated_at": "2026-04-14T09:12:04.000Z",
"status": "draft",
"expires_at": "2026-04-28T23:59:59.000-03:00",
"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",
"pricing_table": {
"currency": "USD",
"package_selection": "multiple",
"packages": [
{
"id": "V1StGXR8Z5jdHi6BmyTq2",
"title": "Website",
"description": "Design and build",
"optional": false,
"includes_tax": false,
"unit": "flat",
"total": "7800.0",
"rows": [
{
"id": "Uakgb4Jk0sQ3dTz9mPw7x",
"name": "Development",
"description": "Frontend and CMS",
"rate": "120.0",
"quantity": "40.0",
"unit": "per_hour",
"optional": false,
"tax_rate_ids": [],
"total": "4800.0",
"tax_total": "0.0"
}
]
}
],
"subtotal": "7800.0",
"tax_total": "0.0",
"total": "7800.0"
}
},
"meta": {
"request_id": "b1f0d2c4-7a9e-4c3b-8d5f-1e2a3b4c5d6e"
}
}