---
title: "Get limits and remaining allowances"
method: GET
path: "/limits"
tags: ["account"]
---

# Get limits and remaining allowances

`GET /limits`

## Request

- Base URL: `https://api.mobilevalidate.com/v1`
- URL: `https://api.mobilevalidate.com/v1/limits`
- Auth: HTTP bearer

Request rate, request sizes, the daily identifiers cap and the key's daily spend cap. Daily counters reset at 00:00 UTC. The public sandbox key is limited per client IP address instead: it answers `sandbox: true`, `rate_limit` with `per: "ip"`, `requests_per_minute` and `requests_per_day` (no `requests_per_second`/`burst`), `jobs.max_numbers` 10 and no `daily_numbers`.

## Response `200`

Current limits.

- object
  - `object` 'limits', required
  - `sandbox` boolean: Present (true) only for the public sandbox key.
  - `rate_limit` object
    - `requests_per_second` integer: Per-key token bucket rate (not for the sandbox key).
    - `burst` integer: Per-key token bucket size (not for the sandbox key).
    - `per` 'key' | 'ip': What the limit applies to: the API key, or (sandbox key) the client IP address.
    - `requests_per_minute` integer: Sandbox key only
    - `requests_per_day` integer: Sandbox key only, per client IP and UTC day.
  - `lookup` object
    - `max_numbers` integer
    - `max_wait_seconds` integer
    - `realtime_enabled` boolean
  - `jobs` object
    - `max_numbers` integer
  - `daily_numbers` object
    - `cap` integer
    - `used` integer
    - `remaining` integer
  - `key_daily_spend` object, nullable
    - `cap` Money
      - `amount` string, required: Decimal USD amount.
      - `currency` 'USD', required
    - `used` Money
      - `amount` string, required: Decimal USD amount.
      - `currency` 'USD', required
    - `remaining` Money
      - `amount` string, required: Decimal USD amount.
      - `currency` 'USD', required
  - `resets_at` string, date-time

## Other responses

- `default`: Error. Branch on `error.code`; `suggestion` (optional) says how to fix the request. A known path called with the wrong method answers `404 not_found` with an `Allow` header listing the methods it accepts.

---

[API](https://skmtc.dev/mobilevalidate/apis/mobilevalidate-api.md) · [All operations](https://skmtc.dev/mobilevalidate/apis/mobilevalidate-api/llms.txt) · [OpenAPI document](https://skmtc.dev/mobilevalidate/apis/mobilevalidate-api/revisions/f2e56c2454ef?raw)