Update billing details
How your account is identified on invoices, and the defaults a new invoice falls back to when dueInDays, taxBps or note is not given. Send only what changes; null clears a field. Live and sandbox keep their own.
apiKeyAuthorizationBearer <token>An API key from the Developers page. rhq_test_ keys reach the sandbox, rhq_live_ keys the live side.
application/json- body
legalName?|nulladdressLines?array<>|The full new list, replacing any you had. At most 4 lines
address?|The same address as its parts, for a form to open again. Send it with addressLines, which is still what invoices print
taxId?|nullbillingEmail?|nulldefaultDueDays?|dueInDays for a new invoice when none is given
defaultTaxBps?|taxBps for a new invoice when none is given
invoiceNote?|note for a new invoice when none is given
country?|Your own home country, for the tax rules engine’s presets (issue #341)
region?|Your own home state or region, for the Indian preset
How you are identified on invoices, and the defaults for a new one
application/json- response
How you are identified on invoices, and the defaults for a new one
legalName*|Printed on invoices instead of your account name, when the two differ
addressLines*array<string>Printed under the legal name, line by line
address*|The same address as its parts, when it was saved with them. Null, lines only
taxId*string|nullbillingEmail*string|nulldefaultDueDays*|dueInDays for a new invoice when none is given. Null, 14 days
defaultTaxBps*|taxBps for a new invoice when none is given. Null, no tax
invoiceNote*|note for a new invoice when none is given
country*|Your own home country, for the tax rules engine’s presets (issue #341)
region*|Your own home state or region, for the Indian preset
actor*|Who last updated these billing details
curl -X PATCH "https://example.com/v1/account/billing" \ -H "Content-Type: application/json" \ -d '{}'{ "legalName": "Northwind Telecom Ltd", "addressLines": [ "1 Market Street", "San Francisco, CA 94105" ], "address": { "line1": "1 Market Street", "line2": "Suite 400", "city": "San Francisco", "postalCode": "94105" }, "taxId": "12-3456789", "billingEmail": "[email protected]", "defaultDueDays": 14, "defaultTaxBps": 2000, "invoiceNote": "Thank you for your business", "country": null, "region": null, "actor": { "kind": "user", "label": "string" }}Get the account GET
The account this API key belongs to, with its environment, the product lines it can order and its wallet.
Ask for a product line POST
Asks for a product line (`numbers`, `domains` or `licences`) to be switched on for this account. Product lines are turned on by the platform; this records the ask, with when it was made, for the team to act on. Asking again keeps the first date. Refused with `product_already_on` for a line the account can already order.