GetAccount - Amazon Pinpoint Email Service


Obtain information about the email-sending status and capabilities of your Amazon Pinpoint account in the current AWS Region.

Request Syntax

GET /v1/email/account HTTP/1.1

URI Request Parameters

The request does not use any URI parameters.

Request Body

The request does not have a request body.

Response Syntax

HTTP/1.1 200 Content-type: application/json { "DedicatedIpAutoWarmupEnabled": boolean, "EnforcementStatus": "string", "ProductionAccessEnabled": boolean, "SendingEnabled": boolean, "SendQuota": { "Max24HourSend": number, "MaxSendRate": number, "SentLast24Hours": number } }

Response Elements

If the action is successful, the service sends back an HTTP 200 response.

The following data is returned in JSON format by the service.


Indicates whether or not the automatic warm-up feature is enabled for dedicated IP addresses that are associated with your account.

Type: Boolean


The reputation status of your Amazon Pinpoint account. The status can be one of the following:

  • HEALTHY – There are no reputation-related issues that currently impact your account.

  • PROBATION – We've identified some issues with your Amazon Pinpoint account. We're placing your account under review while you work on correcting these issues.

  • SHUTDOWN – Your account's ability to send email is currently paused because of an issue with the email sent from your account. When you correct the issue, you can contact us and request that your account's ability to send email is resumed.

Type: String


Indicates whether or not your account has production access in the current AWS Region.

If the value is false, then your account is in the sandbox. When your account is in the sandbox, you can only send email to verified identities. Additionally, the maximum number of emails you can send in a 24-hour period (your sending quota) is 200, and the maximum number of emails you can send per second (your maximum sending rate) is 1.

If the value is true, then your account has production access. When your account has production access, you can send email to any address. The sending quota and maximum sending rate for your account vary based on your specific use case.

Type: Boolean


Indicates whether or not email sending is enabled for your Amazon Pinpoint account in the current AWS Region.

Type: Boolean


An object that contains information about the per-day and per-second sending limits for your Amazon Pinpoint account in the current AWS Region.

Type: SendQuota object


For information about the errors that are common to all actions, see Common Errors.


The input you provided is invalid.

HTTP Status Code: 400


Too many requests have been made to the operation.

HTTP Status Code: 429

See Also

For more information about using this API in one of the language-specific AWS SDKs, see the following: