API Documentation

Issue (commit) an invoice

post
https://api.bitwave.io/v1/invoices/:issue

Commits the invoice (lifecycle: draft → issued). Once issued, its terms — including lines — are frozen; to change them you must :void and issue a replacement.

Issuing makes the invoice eligible to sync to external sync points (e.g. ERP, on-chain). It does not share the invoice with the counterparty (use :share), and it does not guarantee any sync completed — drafts are never synced; issued only unlocks eligibility, and sync is eventual and observed off-resource.

Refused with 409 precondition_failed unless the invoice is currently a draft. Send the current version; a stale value is refused with 409 version_mismatch.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Path Params
string
required

The invoice id.

Body Params

Body for a version-only lifecycle command (:issue / :sync / :void / :delete). Carries the version you last read via GET; a stale value is refused with 409 version_mismatch and nothing changes.

int64
required
≥ 0

The invoice version you last read (via GET).

Headers
string
length ≤ 255

Optional idempotency key (a UUID is ideal). Retrying a command with the same key applies the action at most once and returns the original result, so a network retry can't double-apply. Complements version (which guards concurrent writes).

Responses

Updated about 1 hour ago

Language
Credentials
OAuth2
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json

Updated about 1 hour ago