---
title: "Get included phone-number capacity for a country"
method: GET
path: "/numbers/phones/capacity"
tags: ["Numbers"]
---

# Get included phone-number capacity for a country

`GET /numbers/phones/capacity`

## Request

- Base URL: `https://api.mobilerun.ai`
- URL: `https://api.mobilerun.ai/numbers/phones/capacity`
- Auth: HTTP bearer

Returns included phone capacity for a country. Creating a phone is authoritative.

## Query parameters

- `country` string, required: ISO 3166-1 alpha-2 country code from GET /numbers/phones/countries.

## Response `200`

Capacity retrieved

- object
  - `data` PhoneCapacityResponse, required
    - `included` integer, required
    - `remaining` integer, required
    - `status` 'available' | 'exhausted' | 'not_included', required
    - `includedRemaining` integer, required: Deprecated — always equal to `remaining`. Migrate to `remaining`; this field will be removed in a future revision.

## Other responses

- `400`: Bad Request
- `401`: Unauthorized
- `422`: Unsupported country
- `500`: Internal Server Error
- `502`: Capacity is temporarily unavailable.
- `503`: The phone-number service or capacity information is unavailable.

## Changes

- **2026-10-16** `4ad548c528a8`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/droidrun/apis/droidrun-cloud/changes/numbers/phones/capacity/get.md)

---

[API](https://skmtc.dev/droidrun/apis/droidrun-cloud.md) - [All operations](https://skmtc.dev/droidrun/apis/droidrun-cloud/llms.txt) - [OpenAPI document](https://skmtc.dev/droidrun/apis/droidrun-cloud/revisions/1cc95586c933?raw)