Amazon API Gateway REST API Reference


Represents an AWS account that is associated with API Gateway.

Relation Description Method Templated

A relation that refers to the current resource.


Changes information about the current Account resource.



  "cloudwatchRoleArn" : "String",
  "throttleSettings" : {
    "burstLimit" : "Integer",
    "rateLimit" : "Double"
  "features" : [ "String" ],
  "apiKeyVersion" : "String"

  • cloudwatchRoleArn
  • The ARN of an Amazon CloudWatch role for the current Account.

  • throttleSettings
  • Specifies the API request limits configured for the current Account.

  • burstLimit
  • The API request burst limit, the maximum rate limit over a time ranging from one to a few seconds, depending upon whether the underlying token bucket is at its full capacity.

  • rateLimit
  • The API request steady-state rate limit.

  • features
  • A list of features supported for the account. When usage plans are enabled, the features list will include an entry of "UsagePlans".

  • apiKeyVersion
  • The version of the API keys used for the account.


To view the account info, call GET on this resource.

Error Codes

The following exception may be thrown when the request fails.

  • UnauthorizedException
  • NotFoundException
  • TooManyRequestsException

For detailed error code information, including the corresponding HTTP Status Codes, see API Gateway Error Codes

Example: Get the information about an account.

GET /account HTTP/1.1
Content-Type: application/json
X-Amz-Date: 20160531T184618Z
Authorization: AWS4-HMAC-SHA256 Credential={access_key_ID}/us-east-1/apigateway/aws4_request, SignedHeaders=content-type;host;x-amz-date, Signature={sig4_hash}

The successful response returns a 200 OK status code and a payload similar to the following:

  "_links": {
    "curies": {
      "href": "{rel}.html",
      "name": "account",
      "templated": true
    "self": {
      "href": "/account"
    "account:update": {
      "href": "/account"
  "cloudwatchRoleArn": "arn:aws:iam::123456789012:role/apigAwsProxyRole",
  "throttleSettings": {
    "rateLimit": 500,
    "burstLimit": 1000

In addition to making the REST API call directly, you can use the AWS CLI and an AWS SDK to access this resource.

See Also

API Gateway Limits Developer Guide, AWS CLI