📞
API Docs
  • Welcome
  • NUMBERS / ORDERING
    • List Areas
    • List Numbers
    • Order Numbers - No Cart
    • Delete Numbers
    • Change Call Forward
    • Vanity Tollfree - Search
    • Vanity Toll Free - Order
  • Shopping Cart Ordering
    • Add Number to Cart
    • List Numbers in Cart
    • Delete Number from Cart
    • Complete Order Cart
  • MY INVENTORY
    • List My Nmbers
    • List Call Flows
    • Change CallFlow
    • CDR Records
  • SMS/MMS
    • Send SMS
    • Send MMS
    • Receive SMS/MMS
    • Receive Delivery Receipts
  • Campaigns
    • Submit TollFree Campaign
  • CALL APIS
    • Calls
    • Set Incoming URL
    • Incoming Calls
    • Listing Calls
    • Making Calls
      • Example Code
        • Outbound to Tel#
        • Outbound to SIP Device
        • Example Responses
    • Modifying Live Calls
      • Examples
    • Recordings
      • Get List of Recordings
      • Delete a Recording
  • CALL API MARKUP
    • API Call Markup Language
      • Say
      • Dial
        • Number
        • Client
        • SIP
      • Play
      • Gather
      • Record
      • Hangup
      • Pause
      • Reject
      • Redirect
  • LOOKUPS
    • Carrier and CNAM
  • Number Portability
    • Validate Portability
    • Lookup Port Request
    • Submit Port Request
  • FAXING
    • Create Outbound Fax
    • Lookup Outbound Fax Status
    • List Faxes
    • Download File
  • registered agent
    • List Companies
    • List Registered Agents
    • List Documents
    • Download Document
    • Create Company
    • Delete Company
    • Create Registered Agent
    • Modify Registered Agent
Powered by GitBook
On this page
  1. LOOKUPS

Carrier and CNAM

Lookup Carrier or CNAM records

GET or POST Request

https://v1.api19.com/lookup/number

Lookup the CNAM, Carrier or BOTH for a specific number.

You will be billed for 2 transactions if you use both as lookups are billed separately.

Argument

Required

Type

type

yes

Options: cnam carrier both

number

yes

phone number

key

yes

your api key

CURL Commands

curl https://v1.api19.com/lookup/number \
 -d 'type=cnam'
 -d 'number=3033333333'
 -d 'key=api_token'
curl https://v1.api19.com/lookup/number?type=both&number=3033033333key=apikey

JSON Responses

{
  "data": {
    "carrier": {
      "status": "ok",
      "spid": "979E",
      "total_ported_spid": "50345535",
      "port_date": "2020-08-11 20:55:32",
      "fraud_risk": "high",
      "is_textable": "no",
      "lrn": "7207270948",
      "spid_name": "BANDWIDTH.COM-NSR-10X/1|0",
      "ocn_name": "unknown",
      "ocn": "000",
      "ocn_type": "unknown",
      "carrier": "Bandwidth.com",
      "name": "Bandwidth.com",
      "alt-spid": "",
      "id": "",
      "ported": ""
    },
    "carrier_o": {
      "id": "1",
      "name": "Bandwidth.com"
    }
  },
  "invalid": [],
  "missed": [],
  "number": "+13033333333",
  "pricing": {
    "breakdown": {
      "carrier": "-0.0005",
      "carrier_o": "0"
    },
    "total": "-0.0005"
  },
  "status": "ok",
  "type": "unknown",
  "cnam": "MOBILE ADDICTIO"
}
{
  "status": "ok",
  "cnam": "MOBILE ADDICTIO"
}

PreviousRedirectNextValidate Portability

Last updated 3 months ago