orgasm.dev
Account

List charges

GET
/v1/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.

Authorization

headerAuthorizationBearer <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.

Query Parameters

from?string

First day, inclusive (UTC). Defaults to 30 days ago.

Formatdate
to?string

Last day, inclusive (UTC). Defaults to today.

Formatdate
sessionId?string

Only this session's charges.

Match^ls_[0-9a-z]{20}$
userReference?UserReference

Only those created with this userReference.

Match^(?=.*[A-Za-z])[A-Za-z0-9._:-]{1,128}$
Length1 <= length <= 128
clientReferenceId?ClientReferenceId

Only those created with this clientReferenceId.

Match^(?=.*[A-Za-z])[A-Za-z0-9._:-]{1,128}$
Length1 <= length <= 128
metadata?

Only charges whose session has these metadata values, as metadata[plan]=premium.

limit?integer

How many charges to return.

Range1 <= value <= 1000
Default100
cursor?string

The nextCursor of the previous page.

Response Body

A page of charges, and the totals of every charge that matches.

application/json
  1. response

A page of charges, newest first, and the totals of every charge that matches.

object*string
data*array<>
totals*

Every charge the filters match, across all pages.

hasMore*boolean
nextCursor*string|null
Example Request
curl -X GET 'https://orgasm.dev/v1/charges'
Example Response

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}