---
title: "Reserve an available iMessage number"
method: POST
path: "/v1/imessage/senders/available-numbers/{numberId}/reserve"
tags: ["iMessage"]
---

# Reserve an available iMessage number

`POST /v1/imessage/senders/available-numbers/{numberId}/reserve`

Holds the number for 3 minutes so nobody else can order it while the buyer decides. Place the order (POST /v1/imessage/senders/order with availableNumberId) before the hold expires. No request body.

## Path parameters

- `numberId` string, required

## Response `200`

Number reserved

- object
  - `success` boolean
  - `numberId` string
  - `expiresInSeconds` integer

## Other responses

- `400` — Invalid request
- `401` — Unauthorized
- `409` — The number could not be reserved (already taken)

## Changes

- **2026-09-21** `339f59df69dd` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/zernio/apis/zernio-api/changes/v1/imessage/senders/available-numbers/:numberId/reserve/post.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/dd3865482f9f?raw)