Search Available Numbers

Search available numbers in stock that you can buy to setup an SMS, Voice or WhatsApp channel. You can filter by country, prefix, number type and number capabilities.

You can search available numbers using one of the following attributes:

  • countryCode: 2 digit ISO code of the country, example: US for United States, we follow iso3166-1 standard.

  • types: types of numbers your are searching for, Check API spec for allowed values.

  • features: the capabilities of the number (sms, mms, voice, whatsapp). Check API spec for allowed values.

  • prefix: the area code of the number, this have to be the area code only without country code, you need to pass the country code as well as the prefix if you're looking to filter for a specific area code.

List all available numbers in stock at organization level.

get
Authorizations
Path parameters
organizationIdstring · uuidRequired

The ID for the organization.

Example: d0b85ccc-b63a-4e81-b698-c359d77d250e
Query parameters
limitinteger · min: 1 · max: 99Optional

Limits the number of results to return per page. The default value is 10 and maximum is 99. If the nextPageToken is defined on response, you can use it to get remaining numbers. To know more, refer to the pagination section.

Default: 10
pageTokenstring · max: 8000Optional

Pagination token that keeps of track of the current position in the list. Use it to query remaining results. If not provided, the first page is returned. To learn more about the pagination, please refer to the pagination section on API Access Common API Usage section.

countryCodesstring · iso3166-1[]Optional

A 2-digit ISO 3166-1 country code array.

Example: ["US","NL"]
prefixstring · min: 1 · max: 250Optional

Used to filter numbers belonging to a specific local area-code. It MUST be used in conjunction with the countryCodes filter. Always provide prefixes in full international format.

Example: +1212
testingbooleanOptional
Responses
200
OK
application/json
Responseall of
get
GET /organizations/{organizationId}/numbers-stock-items HTTP/1.1
Host: api.bird.com
Authorization: AccessKey YOUR_SECRET_TOKEN
Accept: */*
{
  "results": [
    {
      "id": "123e4567-e89b-12d3-a456-426614174000",
      "countryCode": "US",
      "type": "local",
      "numberString": "+19283764510",
      "capabilities": {
        "voice": {
          "inbound": true,
          "outbound": true
        },
        "sms": {
          "inbound": true,
          "outbound": true
        },
        "mms": {
          "inbound": true,
          "outbound": true
        }
      },
      "monthlyPrice": {
        "currencyCode": "EUR",
        "amount": 3500000,
        "exponent": -6
      },
      "backOrderRequired": true,
      "backOrderStockId": "text"
    }
  ],
  "nextPageToken": "text"
}

Last updated

Was this helpful?