Get current point balance

GEThttps://api.poe.com/usage/current_balance

Overview

Retrieve your current point balance, including both plan points and add-on points.

Use this endpoint to monitor your available points before making API calls.

Send your Poe API key in the Authorization header:

Authorization: Bearer sk_test_51SAMPLEKEY

All requests must be made over HTTPS.

This endpoint does not accept query or path parameters.

Field	Type	Required	Description
`current_point_balance`	integer	Required	Your current available points

Http	Type	Description
401	`authentication_error`	Authentication failed Invalid API key

Check your balance before making expensive API calls. If balance is insufficient, requests will fail with 402 status.

Monitor your point balance to avoid service interruptions:

No callbacks or webhooks are associated with this endpoint.

Code example

Check remaining Poe API points for your organization.

cURL

curl https://api.poe.com/usage/current_balance \
-H "Authorization: Bearer sk_test_51SAMPLEKEY" \
-H "Accept: application/json"

Example balance

{
"current_point_balance": 295932027
}