Reserve a batch of numbers from a filter
Discover and hold up to 1000 DIDs matching a country / area-code / number-type / capability filter for 15 minutes, then either finalize (purchase, bill, and route) or cancel (release) the batch. Use this when you want the platform to find a block for you rather than posting a pre-built list of E.164s to /numbers/buy-bulk. It polls DIDWW and Telnyx (and platform inventory when provider is unset) and picks the cheapest N; partial holds are returned so you can compare reserved_count against the requested quantity. Inbound DID provisioning only (invariant #45 untouched). Requires the numbers:write scope.
Authorizations
Dashboard JWT token from Clerk
Body
ISO 3166-1 alpha-2 country code.
21 <= x <= 1000Optional area-code / prefix filter (2–5 digits).
local, mobile, toll_free Optional digit-only pattern to match within the number.
contains, starts_with, ends_with Comma-separated capability filter (e.g. sms,voice).
devotel, telnyx, didww