Skip to main content
GET
Read the verified organization's credits and recorded usage

Authorizations

Authorization
string
header
required

Your API key, shaped sp_<key_id>_<secret>, sent as Authorization: Bearer sp_.... It identifies your organization, not a person. Your organization owns the agents, holds the credit, and is billed. Every key your organization holds reaches the same things, so you rotate a key by minting the new one, deploying it, and revoking the old one.

Keep the key on your server. A request that carries a Sec-Fetch-Site header is refused with 400, because only a browser sets that header. Priors sends no CORS headers, so a browser blocks the call before it leaves the page. The secret is shown once when the key is minted and is stored only as a hash. A lost secret is replaced, never recovered.

An administrator of your organization mints and revokes keys in the Priors application, under Settings. There is no endpoint for it: a key reaches your whole organization, so issuing one is an act of administration.

Query Parameters

limit
integer
default:20
Required range: 1 <= x <= 100
before
integer<int64>
Required range: 1 <= x <= 9223372036854776000

Response

Organization credits and a page of ledger entries

organization_id
string
required
enabled
boolean
required
balance
string | null
required
Pattern: ^-?\d+(\.\d+)?$
low_credit_threshold
string
default:0
required

Warning threshold set for your organization; does not change credit enforcement.

Pattern: ^\d+(\.\d+)?$
next_cursor
integer | null
required
Required range: x >= 1
entries
object[]
required
Maximum array length: 100