---
title: "Phone-number stock available event"
method: POST
path: "phone_number.stock_available"
tags: ["Webhook Events"]
---

# Phone-number stock available event

`POST phone_number.stock_available` (webhook)

Fired by the stock sweep (every 6h) the first time a country you watch
via POST /v1/phone-numbers/stock-watches has deliverable numbers again.
The watch is consumed, so the event fires once per watch; the stock
counts are a snapshot and numbers are sold first come, first served.
Buy with POST /v1/phone-numbers/purchase.

## Payload

- WebhookPayloadPhoneNumberStockAvailable — Webhook payload for phone_number.stock_available events
  - `id` string, required — Stable webhook event ID
  - `event` 'phone_number.stock_available', required
  - `stock` object, required
    - `country` string, required — ISO 3166-1 alpha-2 country code of the watched country.
    - `types` object[], required — Number types deliverable at sweep time. Only types with stock are listed.
      - `numberType` string, required — local, mobile, national or toll_free.
      - `availableCount` integer, required — Deliverable numbers at sweep time; first come, first served.
    - `areaCode` string — Set when the watch named an area: the area code (NDC) that is back in stock.
    - `areaName` string — The name of that area, when known.
  - `timestamp` string, date-time, required — UTC time at which Zernio generated this event (set once when the event payload is built, before delivery is queued). Retries and redeliveries keep the original value, so it reflects the event, not the delivery attempt.

## Acknowledgement `200`

Webhook received successfully

---

[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/be448f13ecdc?raw)