{"__v":0,"_id":"5451f9f114af501a00b50fec","category":{"__v":6,"_id":"54510356a66f020800dbaa17","pages":["545103947abbbc0800a5eb90","54535e2008d1800800473d37","5451f81a14af501a00b50fde","54535f6f90000908009522cf","5451f9f114af501a00b50fec","5453606308d1800800473d3d"],"project":"542dbe0ecb19820800c1f4d7","version":"542ecc0a6b0eb6080066ca77","sync":{"url":"","isSync":false},"reference":false,"createdAt":"2014-10-29T15:10:14.801Z","from_sync":false,"order":18,"slug":"carrier-services","title":"Carrier Services"},"editedParams":true,"editedParams2":true,"is_link":false,"parentDoc":null,"project":"542dbe0ecb19820800c1f4d7","user":"544a586d27b7fc140078db12","version":{"__v":29,"_id":"542ecc0a6b0eb6080066ca77","forked_from":"542dbe0fcb19820800c1f4da","project":"542dbe0ecb19820800c1f4d7","createdAt":"2014-10-03T16:17:14.165Z","releaseDate":"2014-10-03T16:17:14.165Z","categories":["542ecc0a6b0eb6080066ca78","542ef44f6b0eb6080066cb24","543bf3e22a30961a00b66eb3","5446952b82bd7e08002768a0","544821ae8d7af31a00dd41ce","544a7885f1aefa08006efc69","544c758e11845f0e001ed8de","544e5565b80812080035be55","544e558dbd51b9080037f8ca","5450b045a66f020800dba73d","5450eb6aa66f020800dba945","5450f39ea66f020800dba989","5450f877a66f020800dba9cf","54510356a66f020800dbaa17","5451274514af501a00b50c99","54513345a66f020800dbab24","54513cc014af501a00b50d24","54515eec14af501a00b50db9","54519b1d14af501a00b50ea9","54519b2aa66f020800dbacb4","54524f9704160008005b1d27","54538d2308d1800800473d95","54538d420c09721000a06a03","54538e5608d1800800473d9a","5453ea9547c30114004fb375","5453eb12b077c31c00067bcb","5453eb27b077c31c00067bcd","5453ed5db077c31c00067bde","548075cbe291c51a00e7e096"],"is_deprecated":false,"is_hidden":false,"is_beta":false,"is_stable":true,"codename":"","version_clean":"2.0.0","version":"2"},"updates":[],"next":{"pages":[],"description":""},"createdAt":"2014-10-30T08:42:25.699Z","link_external":false,"link_url":"","githubsync":"","sync_unique":"","hidden":false,"api":{"basic_auth":true,"method":"post","results":{"codes":[{"name":"","code":"{\n\t\"phone_number\": \"{E.164}\",\n\t\"sid\": \"{BnaLookupSid}\",\n\t\"date_updated\": \"Thu, 30 Oct 2014 08:35:27 -0000\",\n\t\"date_created\": \"Thu, 30 Oct 2014 08:35:26 -0000\",\n\t\"price\": \"0.00\",\n\t\"uri\": \"/v2/Accounts/{AccountSid}/BNA/{BnaLookupSid}\",\n\t\"api_version\": \"v2\",\n\t\"account_sid\": \"{AccountSid}\",\n\t\"city\": \"VIRGINIA\",\n\t\"state\": \"VA\",\n\t\"country_code\": \"US\"\n}","language":"json","status":200},{"name":"","code":"{\n    \"status\": 404,\n    \"message\": \"The requested resource was not found: /v2/Accounts/bad/bad_response.json\"\n}","language":"json","status":404}]},"try":true,"auth":"required","params":[{"_id":"5451f9f114af501a00b50fee","ref":"","in":"path","required":true,"desc":"Account SID.","default":"","type":"string","name":"AccountSid"},{"_id":"5451f9f114af501a00b50fed","ref":"","in":"body","required":true,"desc":"The number of the phone you are attempting to perform the BNA lookup on. Multiple PhoneNumbers to lookup can be specified in a single request.","default":"","type":"array_mixed","name":"PhoneNumber"}],"url":"/:version/Accounts/:AccountSid/Lookups/Bna.json"},"isReference":false,"order":4,"body":"TelAPI provides an endpoint for performing BNA (Billing Name Address) lookups on numbers. BNA lookups provide geolocation information for phone numbers. BNA lookups are currently only available for US numbers.\n\n# **Response Parameters**\n[block:parameters]\n{\n  \"data\": {\n    \"h-0\": \"Parameter\",\n    \"h-1\": \"Description\",\n    \"0-0\": \"sid\",\n    \"0-1\": \"An alphanumeric string identifying this resource.\",\n    \"1-0\": \"account_sid\",\n    \"1-1\": \"An alphanumeric string identifying the account this lookup occurred through.\",\n    \"2-0\": \"date_created\",\n    \"3-0\": \"date_updated\",\n    \"2-1\": \"The date the lookup resource was created.\",\n    \"3-1\": \"The date the lookup resource was last updated.\",\n    \"4-0\": \"phone_number\",\n    \"4-1\": \"The phone number the lookup was performed on.\",\n    \"5-0\": \"first_name\",\n    \"6-0\": \"last_name\",\n    \"5-1\": \"The first name of the individual associated with this phone number.\",\n    \"6-1\": \"The last name of the individual associated with this phone number.\",\n    \"7-0\": \"address\",\n    \"8-0\": \"city\",\n    \"9-0\": \"state\",\n    \"10-0\": \"zip_code\",\n    \"7-1\": \"The address associated with this phone number.\",\n    \"8-1\": \"The city associated with this phone number.\",\n    \"9-1\": \"The US state associated with this phone number.\",\n    \"10-1\": \"The zip code associated with this phone number.\",\n    \"11-0\": \"country_code\",\n    \"12-0\": \"price\",\n    \"13-0\": \"api_version\",\n    \"14-0\": \"uri\",\n    \"11-1\": \"The country code associated with this phone number. (BNA lookups are currently only available in US)\",\n    \"12-1\": \"The price to perform the lookup. If only the city and state of the number are looked up, you are charged $.01. If a full address lookup is successful you are charged $.15.\",\n    \"13-1\": \"The API version being used when the carrier lookup was made.\",\n    \"14-1\": \"The Uniform Resource Identifier to this resource.\"\n  },\n  \"cols\": 2,\n  \"rows\": 15\n}\n[/block]\n# **Example cURL**\n[block:code]\n{\n  \"codes\": [\n    {\n      \"code\": \"curl -X POST -u '{AccountSid}:{AuthToken}' -d 'PhoneNumber={PhoneNumber}' 'https://api.telapi.com/v2/Accounts/{AccountSid}/Lookups/Bna.json'\",\n      \"language\": \"shell\"\n    }\n  ]\n}\n[/block]","excerpt":"shows information on billing name address for some phone number","slug":"bna-lookup","type":"endpoint","title":"Bna Lookup"}

postBna Lookup

shows information on billing name address for some phone number

Definition

{{ api_url }}{{ page_api_url }}

Parameters

Path Params

AccountSid:
required
string
Account SID.

Body Params

PhoneNumber:
required
array of mixed
The number of the phone you are attempting to perform the BNA lookup on. Multiple PhoneNumbers to lookup can be specified in a single request.

Result Format


Documentation

TelAPI provides an endpoint for performing BNA (Billing Name Address) lookups on numbers. BNA lookups provide geolocation information for phone numbers. BNA lookups are currently only available for US numbers. # **Response Parameters** [block:parameters] { "data": { "h-0": "Parameter", "h-1": "Description", "0-0": "sid", "0-1": "An alphanumeric string identifying this resource.", "1-0": "account_sid", "1-1": "An alphanumeric string identifying the account this lookup occurred through.", "2-0": "date_created", "3-0": "date_updated", "2-1": "The date the lookup resource was created.", "3-1": "The date the lookup resource was last updated.", "4-0": "phone_number", "4-1": "The phone number the lookup was performed on.", "5-0": "first_name", "6-0": "last_name", "5-1": "The first name of the individual associated with this phone number.", "6-1": "The last name of the individual associated with this phone number.", "7-0": "address", "8-0": "city", "9-0": "state", "10-0": "zip_code", "7-1": "The address associated with this phone number.", "8-1": "The city associated with this phone number.", "9-1": "The US state associated with this phone number.", "10-1": "The zip code associated with this phone number.", "11-0": "country_code", "12-0": "price", "13-0": "api_version", "14-0": "uri", "11-1": "The country code associated with this phone number. (BNA lookups are currently only available in US)", "12-1": "The price to perform the lookup. If only the city and state of the number are looked up, you are charged $.01. If a full address lookup is successful you are charged $.15.", "13-1": "The API version being used when the carrier lookup was made.", "14-1": "The Uniform Resource Identifier to this resource." }, "cols": 2, "rows": 15 } [/block] # **Example cURL** [block:code] { "codes": [ { "code": "curl -X POST -u '{AccountSid}:{AuthToken}' -d 'PhoneNumber={PhoneNumber}' 'https://api.telapi.com/v2/Accounts/{AccountSid}/Lookups/Bna.json'", "language": "shell" } ] } [/block]