Reclaim a quarantined number | Voicebip

Moves a number from quarantined status back to provisioned for the same workspace. The number must have been released within the last 30 days. The agent must belong to the requesting workspace. Channels default to [“voice”] if not specified.

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Path parameters

number_idstringRequired

Request

This endpoint expects an object.

agent_idstringRequired

Agent to assign the reclaimed number to

channelslist of enumsOptional

Defaults to [voice] if not specified

Allowed values:

Response

Number reclaimed

number_idstring

e164string

typeenum

statusenum

agent_idstring

channelslist of enums

mnostring

provisioned_atdatetime

Errors

404

Reclaim Number Request Not Found Error

$	curl -X POST https://api.voicebip.com/v1/numbers/number_id/reclaim \
>	-H "Authorization: Bearer <token>" \
>	-H "Content-Type: application/json" \
>	-d '{
>	"agent_id": "agent_id"
>	}'

1	{
2	"number_id": "number_id",
3	"e164": "e164",
4	"type": "geo_did",
5	"status": "available",
6	"agent_id": "agent_id",
7	"channels": [
8	"voice"
9	],
10	"mno": "mno",
11	"provisioned_at": "2024-01-15T09:30:00Z"
12	}