---
title: "List instantly available iMessage numbers"
method: GET
path: "/v1/imessage/senders/available-numbers"
tags: ["iMessage"]
---

# List instantly available iMessage numbers

`GET /v1/imessage/senders/available-numbers`

Phone numbers the provider has already registered and can assign on the
spot. Order one by passing its `id` as `availableNumberId` to
POST /v1/imessage/senders/order: the sender activates immediately
instead of after the usual provisioning wait. Reserve it first with
POST /v1/imessage/senders/available-numbers/{numberId}/reserve while the
buyer decides. The list is a snapshot; a number can be taken between
listing and ordering.

## Query parameters

- `region` 'US' | 'GB'

## Response `200`

Available numbers

- object
  - `numbers` object[]
    - `id` string — Pass as availableNumberId when ordering
    - `phone` string — E.164
    - `region` string
    - `location` string — Area the provider reports for the number (e.g. a US state), when known
  - `region` string, nullable

## Other responses

- `400` — Invalid request
- `401` — Unauthorized
- `502` — The provider could not list numbers; ordering without availableNumberId still works

## Changes

- **2026-09-25** `2c04683ce694` — 4 info
  - added the optional property `details/adAccountId` to the response with the `400` status
  - added the optional property `details/createdObjects` to the response with the `400` status
  - added the optional property `details/stage` to the response with the `400` status
  - added the optional property `details/unconfirmedWrite` to the response with the `400` status
- **2026-09-21** `339f59df69dd` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/zernio/apis/zernio-api/changes/v1/imessage/senders/available-numbers/get.md)

---

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