List charges
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.
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.
from?stringFirst day, inclusive (UTC). Defaults to 30 days ago.
dateto?stringLast day, inclusive (UTC). Defaults to today.
datesessionId?stringOnly this session's charges.
^ls_[0-9a-z]{20}$userReference?UserReferenceOnly those created with this userReference.
^(?=.*[A-Za-z])[A-Za-z0-9._:-]{1,128}$1 <= length <= 128clientReferenceId?ClientReferenceIdOnly those created with this clientReferenceId.
^(?=.*[A-Za-z])[A-Za-z0-9._:-]{1,128}$1 <= length <= 128metadata?Only charges whose session has these metadata values, as metadata[plan]=premium.
limit?integerHow many charges to return.
1 <= value <= 1000100cursor?stringThe nextCursor of the previous page.
A page of charges, and the totals of every charge that matches.
application/json- response
A page of charges, newest first, and the totals of every charge that matches.
object*stringdata*array<>totals*Every charge the filters match, across all pages.
hasMore*booleannextCursor*string|nullcurl -X GET 'https://orgasm.dev/v1/charges'Returned by listCharges with a live key.
{ "object": "list", "data": [ { "id": "ls_8f3kq2m7x9w4c1n6t5ra.orgasm.1", "object": "charge", "mode": "live", "sessionId": "ls_8f3kq2m7x9w4c1n6t5ra", "unit": "orgasm", "index": 1, "at": "2026-10-21T14:09:02Z", "credits": 1, "freeCredits": 0, "paidCredits": 1, "pendingCredits": 0, "amountUsd": 4, "packages": [ { "id": "pkg_4n7q2w9e5r1t8y3u6i0o", "credits": 1, "pricePerCredit": 4 } ], "returned": false, "ownGpu": false, "apiKeyId": "key_9d2f5g8h1j4k7l0z3x6c", "userReference": "9f2c41ab7e05d3a86b1c", "clientReferenceId": "round_1842", "metadata": { "plan": "premium" } } ], "totals": { "charges": 1, "credits": 1, "freeCredits": 0, "paidCredits": 1, "pendingCredits": 0, "amountUsd": 4 }, "hasMore": false, "nextCursor": null}Get credits GET
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.
List models GET
The models behind each signal: what each produces, which inputs it needs, who it applies to, and where it is available. No key needed.