---
title: "Get account rate limits and send limits"
method: GET
path: "/limits"
tags: ["Limits"]
---

# Get account rate limits and send limits

`GET /limits`

Returns current rate limit and send limit information for your account.

This endpoint is the recommended way to check your account's operational limits.
Use `/usage` endpoints for historical usage analytics.

**Response includes:**
- `rateLimit` - API request rate limit (requests per second)
- `sendLimit` - Email sending limit (emails per hour)
- `billing` - Credit balance and auto-recharge configuration

**Notes:**
- This request counts against your rate limit
- `sendLimit` may be null if the service is temporarily unavailable
- `billing` is null if billing is not configured
- Send limit resets at the top of each hour

## Response `200`

Account rate limits and send limits

- LimitsResponse — Account rate limits and send limits response
  - `success` true, required
  - `data` UsageData, required — Current usage and limit information
    - `rateLimit` RateLimitUsage, required — API rate limit status
      - `limit` integer, required — Maximum requests allowed per period
      - `remaining` integer, required — Requests remaining in current window
      - `reset` integer, required — Unix timestamp when the limit resets
      - `period` 'second', required — Time period for the limit
    - `sendLimit` SendLimitUsage, required — Email send limit status (hourly cap)
      - `limit` integer, nullable, required — Maximum emails allowed per hour (null = unlimited)
      - `used` integer, required — Emails sent in current period
      - `remaining` integer, nullable, required — Emails remaining in current period (null if unlimited)
      - `usagePercent` number, nullable, required — Usage as a percentage (null if unlimited)
      - `approaching` boolean, required — Whether approaching the limit (>90%)
      - `exceeded` boolean, required — Whether the limit has been exceeded
      - `period` 'hour', required — Time period for the limit
      - `resetsAt` string, date-time, required — ISO timestamp when the limit window resets (top of next hour)
    - `billing` BillingUsage, required — Billing and credit information
      - `creditBalance` string, required — Current credit balance as formatted string (e.g., "25.50")
      - `creditBalanceCents` integer, required — Current credit balance in cents for precise calculations
      - `autoRecharge` object, required — Auto-recharge configuration
        - `enabled` boolean, required — Whether auto-recharge is enabled
        - `threshold` string, required — Balance threshold that triggers recharge
        - `amount` string, required — Amount to recharge when triggered
      - `hasPaymentMethod` boolean, required — Whether a payment method is configured
  - `meta` ApiMeta, required
    - `requestId` string, required — Unique request identifier for debugging and support

## Other responses

- `401` — Invalid or missing API key
- `429` — Rate limit exceeded
- `500` — Internal server error

---

[API](https://skmtc.net/arkhq-io/apis/ark-email-api.md) · [All operations](https://skmtc.net/arkhq-io/apis/ark-email-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/arkhq-io/ark-email-api/revisions/98a90852ffca/schema)