Get usage
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.
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).
dateto?stringLast day, inclusive (UTC).
dateUsage per day, and totals.
application/json- response
Usage per day over a range of days.
object*stringmode*string"test""live"from*stringdateto*stringdatedays*array<>totals*curl -X GET 'https://orgasm.dev/v1/usage'Returned by getUsage.
{ "object": "usage", "mode": "test", "from": "2026-10-14", "to": "2026-10-16", "days": [ { "date": "2026-10-14", "liveSessions": 3, "liveSeconds": 1980, "recordings": 1, "recordingSeconds": 780, "orgasms": 2, "ruins": 0, "edges": 3, "sessionMinimums": 0, "credits": 0 }, { "date": "2026-10-15", "liveSessions": 0, "liveSeconds": 0, "recordings": 0, "recordingSeconds": 0, "orgasms": 0, "ruins": 0, "edges": 0, "sessionMinimums": 0, "credits": 0 }, { "date": "2026-10-16", "liveSessions": 5, "liveSeconds": 3420, "recordings": 2, "recordingSeconds": 1440, "orgasms": 3, "ruins": 1, "edges": 2, "sessionMinimums": 1, "credits": 0 } ], "totals": { "liveSessions": 8, "liveSeconds": 5400, "recordings": 3, "recordingSeconds": 2220, "orgasms": 5, "ruins": 1, "edges": 5, "sessionMinimums": 1, "credits": 0 }}Send a test webhook POST
Sends one signed sample event of the given type to the endpoint now and reports how your server answered. The sample is marked `test` mode and belongs to no real session. Use it to check signature verification before going live.
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.