Account, keys and webhooks ›
Get tier
GET
/v1/tierGet tier.
Requestcurl
- curl https://agental.io/v1/tier \
- -H "Authorization: Bearer $AGENTAL_API_KEY"
Answer200 OK · Tier
- {
- "enforced": boolean,
- "tier": integer,
- "from": "plan" | "money" | "hand",
- "plan": string | null,
- "perQuarterMb": integer,
- "perHourMb": integer,
- "startedQuarterMb": integer,
- "startedHourMb": integer,
- "leftQuarterMb": integer,
- … 8 more
- }
Replaced by GET /v1/burst.
Headers
AuthorizationrequiredBearer key | An API key that may make this call. |
Returns
200 Replaced by GET /v1/burst. The old shape, worked out from the account's burst: the free burst stands for the tier's amounts, and the meter for what was started.
Tier17 fields
enforcedboolean
tierinteger
The place among the plans of the plan whose limits the account has.
fromplanmoneyhand
plan or hand.
More
Money no longer raises anything.planstringnull
perQuarterMbinteger
The free burst, in megabytes.
perHourMbinteger
The same.
startedQuarterMbinteger
What the burst meter reads.
startedHourMbinteger
The same.
leftQuarterMbinteger
What may be started now for nothing.
leftHourMbinteger
The same.
leftMbinteger
The same.
overQuarterMbinteger
By how much the meter is over the free burst.
overHourMbinteger
The same.
mayStartboolean
receivedUsdnumber
Always 0: money no longer raises anything.
firstPaidAtstringnull
Always null.
nextnull
Always null: nothing raises an account but a change of plan.
Errors and other answers
| 400 | invalid_request. The key belongs to no account. |
| 404 | The account behind the key is gone. |
Every error answers { "error": { "code", "message" } }; a key without the action a call needs answers 403 key_action_forbidden, naming it.