v1

latestOpenAPI 3.0.42026-08-04342835917.6 KB

BillingAccount

Grants a voucher to a customer.

Provide exactly one of validity (a duration from now) or expiresAt (an explicit instant) — not both, not neither. The grant immediately raises the customer's serve allowance.

post/vouchers

Request body

organizationIdstring required

The id of the organization to grant the voucher to.

amountnumber double required

The face value of the voucher in dollars.

validitystring nullable

How long the voucher stays valid, counted from now. Serialized as a duration string in the format [days.]hh:mm:ss (the days part is optional): "30.00:00:00" = 30 days, "7.00:00:00" = 7 days, "12:00:00" = 12 hours. Must be positive. Provide this or expiresAt, not both.

expiresAtstring date-time nullable

An explicit expiry instant as an ISO-8601 timestamp (e.g. "2026-12-31T23:59:59Z"). Use this instead of validity when you know the exact date the voucher should expire. Provide this or validity, not both.

Response

voucherIdstring required

The id of the granted voucher.