Users API
Keeping your user profile up to date helps SendGrid verify who you are and share important communications with you.
You can learn more in the SendGrid Account Details documentation.
Retrieve your credit balance
GET /v3/user/credits
Base url: https://api.sendgrid.com
This endpoint allows you to retrieve the current credit balance for your account.
Each account has a credit balance, which is a base number of emails it can send before receiving per-email charges. For more information about credits and billing, see Billing and Plan details information.
Authentication
- API Key
Headers
The on-behalf-of header allows you to make API calls from a parent account on behalf of the parent's Subusers or customer accounts. You will use the parent account's API key when using this header. When making a call on behalf of a customer account, the property value should be "account-id" followed by the customer account's ID (e.g., on-behalf-of: account-id <account-id>). When making a call on behalf of a Subuser, the property value should be the Subuser's username (e.g., on-behalf-of: <subuser-username>). See On Behalf Of for more information.
Responses
The remaining number of credits available on your account.
The total number of credits assigned to your account.
The number of overdrawn credits for your account.
The number of credits that you have used.
The date that your credit balance was last reset.
The next date that your credit balance will be reset.
The frequency at which your credit balance will be reset.
Need some help?
We all do sometimes. Get help now from the Twilio SendGrid Support Team.
Running into a coding hurdle? Lean on the wisdom of the crowd by browsing the SendGrid tag on Stack Overflow or visiting Twilio's Stack Overflow Collective.
