Lookup SMS Carrier

Overview

Lookup carrier details for specified number.

Requests to this endpoint will incur pre-pay API charges to the account. An account must have the data API enabled in order to complete the request. Please contact [e-mail] if you need assistance.

Authentication

Authentication is done by passing your TSG Global API key via the Authorization header in the format "Authorization: Bearer <api_key>"

Method

Lookup carrier details for a specific number.

GET https://api-service.tsgglobal.world/v2/dids/<number>/sms_carrier_lookup

Path Parameters

Name	Type	Description
number*	string	Phone number you are looking to query.

200: OK

{
  "enabled": true,
  "number": "12342341234",
  "operator": "TSG Global, Inc."
}

403: Forbidden

{
  "errors" => [
    {
      "code" => "account_inactive",
      "detail" => "The associated account is inactive, please contact support if you think this is an error."
    }
  ]
}

### or ###
{
  "errors" => [
    {
      "code" => "lrn_dip_disabled",
      "detail" => "The associated account has lrn_dips disabled, please contact support if you think this is an error."
    }
  ]
}

402: Payment Required

Example CURL

curl -n https://api-service.tsgglobal.world/v2/dids/12342341234/sms_carrier_lookup \  -H "Authorization: Bearer <api_key>"