Skip to content
Developers
Get started
Early access: these pages are being written and reviewed. Facts in the header boxes come straight from the product.

Get the organization's usage meters (any member)

GET
/api/v1/org/usage-meters
curl --request GET \
--url https://api.pitch2sale.com/api/v1/org/usage-meters \
--header 'Authorization: Bearer <token>'

One row per meter: meter, unit, used, reserved, limit (null = unlimited, 0 = not included), remaining, percent, status, source, byo, period_start, resets_at, and wallet: once the allowance is used up, paying (the prepaid wallet funds new use), low (the balance is above zero but below the next hold, e.g. a call’s 15 minutes: top up), empty (zero balance: top up) cap_reached (this period’s wallet safety limit is reached) or paused (calls, AI voice agent and live translation only: new wallet-paid calls are paused for the workspace; show “Calling from the wallet is paused. Contact support.”); null when the wallet does not apply (wallet off, trial or Solo, not a wallet meter, a meter not sold from the wallet on this plan, or allowance not used up). Readable by every member, so it carries no money: no balance, price or rate.

OK

Authentication required or token invalid

Media typeapplication/json
object
error
required
string
code
string
message
string
details
Array<object>
object
field
required
string
message
required
string
code
required
string
Examplegenerated
{
"error": "example",
"code": "example",
"message": "example",
"details": [
{
"field": "example",
"message": "example",
"code": "example"
}
]
}

Role permission or token scope missing; OAuth app tokens are not accepted on this route

Media typeapplication/json
object
error
required
string
code
string
message
string
details
Array<object>
object
field
required
string
message
required
string
code
required
string
Examplegenerated
{
"error": "example",
"code": "example",
"message": "example",
"details": [
{
"field": "example",
"message": "example",
"code": "example"
}
]
}

Rate limit exceeded

Media typeapplication/json
object
error
required
string
code
string
message
string
details
Array<object>
object
field
required
string
message
required
string
code
required
string
Examplegenerated
{
"error": "example",
"code": "example",
"message": "example",
"details": [
{
"field": "example",
"message": "example",
"code": "example"
}
]
}