numbers.search

Numbers available to rent.

Reference

POST/api/v1/managed-numbers/search

Auth: API key in X-API-Key
Content: application/json
Returns: 200 · Response Search Numbers Api V1 Managed Numbers Search Post

Numbers the carrier has for sale right now. An empty list is a normal answer — India local inventory is thin and moves — not an error to retry. When a filtered search finds nothing, this retries without the filters and says so with ``exact_match: false``. Indian local inventory is thin enough that asking for a city *and* a digit pattern usually returns nothing, and "Nothing available matching that right now" is a dead end that tells a customer nothing about what they could actually buy. Showing what exists, labelled as not what they asked for, answers the question behind the question.

Arguments

Argument	In	Type	Required
`telephony_configuration_id`	body	`integer`	required
`country_iso`	body	`string`	default "IN"
`number_type`	body	`string`	default "local"
`city`	body	`string`	optional
`pattern`	body	`string`	optional
`limit`	body	`integer`	default 20

Example request

curl -X POST "https://api.decibyl.ai/api/v1/managed-numbers/search" \
  -H "X-API-Key: dcb_your_key" \
  -H "Content-Type: application/json" \
  -d '{"telephony_configuration_id":1,"country_iso":"IN","number_type":"local","city":"string","pattern":"string","limit":20}'

Response

{}

Errors

Status	When
`404`	Not found
`422`	Validation Error