Phone numbers

List available phone numbers

Returns phone numbers your company could buy, with what each would cost. Nothing is reserved or charged.

GET

https://api.portal.magicdoor.com/company-app/phones/available

Authorization

Authorizationstringrequired

Bearer token — Send your API token in the Authorization header as Bearer <token>. Requests without a valid token are rejected with 401 Unauthorized.

Query parameters

startsWithstring

Digits the number should start with, such as an area code. 1 to 7 digits.

default: 208example: 208

Response

200 · Numbers you could buy.

phoneNumbersobject[]

The available numbers.

401 · The access token is missing, expired, or not valid.

Leaving startsWith out searches the 208 area code. The numbers are live availability from the carrier, so one can be taken by somebody else between listing and buying.

Request

curl --request GET \
  --url 'https://api.portal.magicdoor.com/company-app/phones/available?startsWith=208' \
  --header 'Authorization: Bearer <token>'

Response

{
  "phoneNumbers": [
    {
      "phoneNumber": "+12085550100",
      "monthlyCost": 2,
      "upfrontCost": 1
    },
    {
      "phoneNumber": "+12085550118",
      "monthlyCost": 2,
      "upfrontCost": 1
    }
  ]
}