Number lookup

Aculab cloud has a facility that allows you to check the line type and the carrier name of a phone number.

• Check
• Check

• Check

  This is used to check the phone number line type, carrier and country.

  Authorisation

  This API uses basic authentication, using your cloud account username and API Access Key.

  Username	:	cloudID/username (e.g. 1-2-0/bob@example.com)
  Password	:	API Access key

  Request:

  Url	:	https://ws.aculabcloud.net/number_lookup/v1/check
  Methods	:	GET

  
  

  Parameter	Value	Description
  phone_number	string	international format of the specified phone number

  Returns on success:

  A JSON object containing the following parameters:

  Parameter	Type	Availability	Description
  number_found	bool	Always	true if details for the specified phone number were found
  country_name	string	If number_found is true	the country name assigned to the specified phone number
  country_code	string	If number_found is true	the three-letter ISO 3166-1 alpha-3 country code assigned to the specified phone number
  line_type	string	If number_found is true	the line type of the specified phone number. One of the following: mobile, landline, toll_free, voip, other.
  carrier	string	If number_found is true	the name of the carrier which the specified phone number is registered with

  Example:

  https://ws-1-2-0.aculabcloud.net/number_lookup/v1/check?phone_number=443069990123

  Response:

  If successful you will receive the example JSON response:

  {
      "number_found": true,
      "country_name": "United States",
      "country_code": "USA",
      "line_type": "mobile",
      "carrier": "United States Cellular Corp. (U.S. Cellular)"
  }

  or

  {
      "number_found": false
  }

  Or on error an HTTP error containing a JSON response. For example:

  {
      "error": {
          "code": "400 Bad Request",
          "text": "Invalid phone number format",
          "link": "https://www.aculab.com/cloud/web-services/number-lookup/",
          "datetime": "2022-02-03_15:41:58"
      },
      "request": {
          "url": "/number_lookup/v1/check",
          "datetime": "2022-02-03_15:41:58"
      }
  }

  Charging information

  Each call to this web service is charged at a standard rate, whether the supplied phone number is found or not.

  Cost information is available on the pricing page on the Cloud Console and will be reflected in the monthly account statements.