Get credits
Your company's credit balance: what is available, what is left of the 20 free credits, and each package with its price per credit, what it has left and when it expires. Credits are shared by your company's members and keys and are drawn only by live sessions; a test key and a billing key read the same balance.
At zero, createLiveSession with a live key is refused with
credits_exhausted (402) while enforced is true. To buy credits,
talk to sales@orgasm.dev; a package's credits post once its invoice is
paid.
AuthorizationBearer <sk_test_… or sk_live_…>A secret key, sent as Authorization: Bearer sk_test_…. Keep it on your server. Test keys reach the sandbox; live keys reach live analysis. In the sandbox any key that starts with sk_test_ works.
The balance.
application/json- response
Your company's credits, shared by its members and keys. Free credits are used first, then the package that expires soonest.
object*stringdomain*stringThe company domain the credits belong to.
balance*numberCredits available, in halves. Below zero when sessions that were running at zero used more; the next package that posts covers it.
free*packages*array<>Every package with credits left, in the order they are used, then the used and expired ones.
expiringSoon*|Credits that expire within 30 days, and the first such expiry, or null.
enforced*booleanWhether a new live session is refused at zero (credits_exhausted). false while orgasm.dev is only counting.
curl -X GET 'https://orgasm.dev/v1/credits'Returned by getCredits.
{ "object": "credit_balance", "domain": "studio.example", "balance": 9412.5, "free": { "granted": 20, "remaining": 0 }, "packages": [ { "id": "pkg_4n7q2w9e5r1t8y3u6i0o", "object": "credit_package", "package": "growth", "credits": 10000, "remaining": 9412.5, "pricePerCredit": 4, "postedAt": "2026-10-20T17:04:00Z", "expiresAt": "2027-10-20T17:04:00Z" }, { "id": "free", "object": "credit_package", "package": "free", "credits": 20, "remaining": 0, "pricePerCredit": 0, "postedAt": "2026-10-16T14:00:00Z", "expiresAt": null } ], "expiringSoon": null, "enforced": true}Get usage GET
Your company's live-session and recording minutes per day for the key's mode, and the orgasms, ruins, edges and session minimums counted, with the credits they drew (always 0 in test mode). Defaults to the last 30 days. A billing key reads live usage.
List charges GET
Every orgasm, ruin, edge and session minimum your company's live sessions were charged for, newest first, with what each cost in US dollars and the session's `userReference`, `clientReferenceId`, metadata and key, so that you can break your costs down by person, by your own session or by any metadata value. `totals` covers every charge the filters match, across all pages. A charge's paid credits cost their package's price per credit; free credits cost nothing; credits used past zero are `pendingCredits` until a package posts and covers them, at that package's price. Credits that expire unused belong to no charge. In test mode every charge is counted with no credits drawn. A billing key reads live charges.