Get Booking Agreement

Return the rental agreement for a booking. If the booking has never had one, it is created from the supplier's template — with that booking's details merged in — and returned.

GET /v1/bookings/{id}/agreement

Authentication

Requires a valid API key with agreements:read scope.

Path Parameters

Parameter	Type	Description
id	integer	Booking ID

Request Example

curl "https://app.equipdash.com/api/v1/bookings/4821/agreement" \
  -H "Authorization: Bearer YOUR_API_KEY"

Response

{
  "data": {
    "booking_id": 4821,
    "title": "Rental Agreement",
    "status": "draft",
    "status_label": "Not signed",
    "signing_url": "https://app.equipdash.com/agreement/AbC…",
    "sent_at": null,
    "send_count": 0,
    "viewed_at": null,
    "signed_at": null,
    "signed_name": null,
    "signed_ip": null,
    "signed_via": null,
    "terms": "This agreement is between Example Outfitters and Jane Doe …"
  },
  "meta": {
    "request_id": "req_abc123",
    "timestamp": "2026-08-14T09:00:00+00:00"
  }
}

signing_url needs write access

The signing link is the whole authorization to sign, so it is only returned to a key that holds agreements:write. With agreements:read alone the response is identical but signing_url is null.

Errors

Status	Code	When
403	agreements_disabled	The business has rental agreements switched off
409	agreement_not_applicable	The booking has no rental items, so it has no agreement
404	resource_not_found	No booking with that ID belongs to this API key's business