doctl account ratelimit
Generated on 23 Jun 2025
from doctl version
v1.131.0
Usage
doctl account ratelimit [flags]Aliases
rlDescription
Retrieve the following details about your account’s API usage:
- The current limit on your account for API calls (default is 5,000 per hour per OAuth token)
- The number of API calls you have made in the last hour
- When the API call count resets to zero, which happens hourly
Note that these details are per OAuth token and are bound to the token you used when calling doctl auth init at setup time.
Example
The following example retrieves the number of API calls you have left for the hour:
doctl account ratelimit --format RemainingFlags
| Option | Description |
|---|---|
--format |
Columns for output in a comma-separated list. Possible values: Limit, Remaining, Reset. |
--help, -h |
Help for this command |
--no-header |
Return raw data with no headers Default: false |
Related Commands
| Command | Description |
|---|---|
| doctl account | Display commands that retrieve account details |
Global Flags
| Option | Description |
|---|---|
--access-token, -t |
API V2 access token |
--api-url, -u |
Override default API endpoint |
--config, -c |
Specify a custom config file Default: |
--context |
Specify a custom authentication context name |
--http-retry-max |
Set maximum number of retries for requests that fail with a 429 or 500-level error
Default: 5 |
--http-retry-wait-max |
Set the minimum number of seconds to wait before retrying a failed request
Default: 30 |
--http-retry-wait-min |
Set the maximum number of seconds to wait before retrying a failed request
Default: 1 |
--interactive |
Enable interactive behavior. Defaults to true if the terminal supports it (default false)
Default: false |
--output, -o |
Desired output format [text|json] Default: text |
--trace |
Show a log of network activity while performing a command Default: false |
--verbose, -v |
Enable verbose output Default: false |