ResellerHQ
Log inTry the sandbox free
GuidesAPI reference
Invoices

Share an invoice

POST
/v1/invoices/{id}/share

Creates a public, read-only link to this invoice that needs no API key: GET /public/invoices/{token}. Calling this again returns the same token, so the share button is safe to press twice. Works on an invoice in any status.

Authorization

apiKey
headerAuthorizationBearer <token>

An API key from the Developers page. rhq_test_ keys reach the sandbox, rhq_live_ keys the live side.

Path Parameters

id*string

Response Body

The token is the same one already shared, if there was one

application/json
  1. response

The token is the same one already shared, if there was one

token*string

Put at the end of /public/invoices/{token}. Unguessable; treat it like a capability on this one invoice, not a secret you otherwise protect

createdAt*string
Formatdate-time
curl -X POST "https://example.com/v1/invoices/inv_01K6XJ4Q8ZT3M9R5V2B7WDHNCA/share"
{  "token": "kq3F2n8y9mQe...base64url...",  "createdAt": "2026-10-07T11:04:31.000Z"}

Void an invoice POST

Withdraws an open invoice. Its number is not used again, and its sales can go on another invoice. A paid invoice cannot be voided, and neither can one that already carries a credit note: credit the rest of that one instead.

Revoke an invoice link DELETE

The public link stops working at once. An invoice with no link also answers 204: there is nothing to revoke. Sharing again afterwards mints a different token; the old one stays dead for good.