{"_id":"57624356653c2d2200fec7d4","parentDoc":null,"project":"55c8cff571d7580d0063a5e5","user":"55c8cf9471d7580d0063a5e4","category":{"_id":"57624356653c2d2200fec7a1","version":"57624356653c2d2200fec79c","project":"55c8cff571d7580d0063a5e5","__v":0,"sync":{"url":"","isSync":false},"reference":true,"createdAt":"2016-03-29T04:48:51.292Z","from_sync":false,"order":13,"slug":"account-extension-caller-ids","title":"Account Extension Caller IDs"},"version":{"_id":"57624356653c2d2200fec79c","__v":21,"project":"55c8cff571d7580d0063a5e5","createdAt":"2016-06-16T06:12:38.244Z","releaseDate":"2016-06-16T06:12:38.244Z","categories":["57624356653c2d2200fec79d","57624356653c2d2200fec79e","57624356653c2d2200fec79f","57624356653c2d2200fec7a0","57624356653c2d2200fec7a1","57624356653c2d2200fec7a2","57624356653c2d2200fec7a3","57624356653c2d2200fec7a4","57624356653c2d2200fec7a5","57624356653c2d2200fec7a6","57624356653c2d2200fec7a7","57624356653c2d2200fec7a8","57624356653c2d2200fec7a9","57624356653c2d2200fec7aa","5779ca1b99b40b0e005abb3a","5779d198aea88b0e00f63277","5797d3ab17ced017003c4be4","57ac170ef1cdae0e0053cdfc","57dbfc723ed3450e00dc9e6d","5804d12d16161c0f0077df9b","5841064b652e5b0f0015a7c8","588b5e5f2966b2230009cbf9","58a68ebf3239fa0f00857619","58c23c8b4922930f0050ac91","58fd1460809fc30f00f2ee07","5934eaf5328680002d77de6a","594bf91601cfe6000f40f4c5","595c4ed696b447001ba0cf6d","596524495cee50001575f5be","5970d4f1313162004dd303b5","59780fac24dbd1001a1fa057","59a8cfd3ead78a002d63cafe","59e0323d93da1f001c9ec170","5b0c16f2be9fcb0003e28222"],"is_deprecated":false,"is_hidden":false,"is_beta":true,"is_stable":true,"codename":"","version_clean":"4.0.0","version":"4"},"__v":1,"updates":[],"next":{"pages":[],"description":""},"createdAt":"2016-03-29T20:00:20.326Z","link_external":false,"link_url":"","githubsync":"","sync_unique":"","hidden":false,"api":{"results":{"codes":[]},"settings":"","auth":"required","params":[],"url":""},"isReference":true,"order":0,"body":"Outgoing calls via the Post /calls API supports Caller ID settings.  This page gives an overview on how to retrieve the list of available account phone number to be used as caller ID.\n\n## Supported Services\n* [List Caller Ids](doc:list-account-extension-caller-ids) \n\n## Full Object\nHere are all of the properties you can expect for Caller ID objects:\n[block:parameters]\n{\n  \"data\": {\n    \"h-0\": \"Property\",\n    \"h-1\": \"Type\",\n    \"0-0\": \"`number`\",\n    \"0-1\": \"String\",\n    \"1-0\": \"`name`\",\n    \"1-1\": \"String\",\n    \"2-0\": \"`type`\",\n    \"h-2\": \"Description\",\n    \"0-2\": \"Phone number, in E.164 format\",\n    \"1-2\": \"Name you have supplied for this number\",\n    \"2-1\": \"Enum: `account`, `extra`\",\n    \"2-2\": \"Type of Caller ID. `account` means this number is registered to your account, and `extra` refers to extra numbers which you have authorized, which are not managed under Phone.com.\"\n  },\n  \"cols\": 3,\n  \"rows\": 3\n}\n[/block]\nHere is an example:\n[block:code]\n{\n  \"codes\": [\n    {\n      \"code\": \"{\\n    \\\"number\\\": \\\"+19999999999\\\",\\n    \\\"name\\\": \\\"Mr. Potato\\\",\\n    \\\"type\\\": \\\"account\\\"\\n}\",\n      \"language\": \"json\"\n    }\n  ]\n}\n[/block]","excerpt":"API users with Extension scope access token does not have access to the Phone Number API.  This API helps user to retrieve available account phone numbers to be used as caller id via the /Calls API.","slug":"account-extension-caller-ids","type":"basic","title":"Caller IDs"}

Caller IDs

API users with Extension scope access token does not have access to the Phone Number API. This API helps user to retrieve available account phone numbers to be used as caller id via the /Calls API.

Outgoing calls via the Post /calls API supports Caller ID settings. This page gives an overview on how to retrieve the list of available account phone number to be used as caller ID. ## Supported Services * [List Caller Ids](doc:list-account-extension-caller-ids) ## Full Object Here are all of the properties you can expect for Caller ID objects: [block:parameters] { "data": { "h-0": "Property", "h-1": "Type", "0-0": "`number`", "0-1": "String", "1-0": "`name`", "1-1": "String", "2-0": "`type`", "h-2": "Description", "0-2": "Phone number, in E.164 format", "1-2": "Name you have supplied for this number", "2-1": "Enum: `account`, `extra`", "2-2": "Type of Caller ID. `account` means this number is registered to your account, and `extra` refers to extra numbers which you have authorized, which are not managed under Phone.com." }, "cols": 3, "rows": 3 } [/block] Here is an example: [block:code] { "codes": [ { "code": "{\n \"number\": \"+19999999999\",\n \"name\": \"Mr. Potato\",\n \"type\": \"account\"\n}", "language": "json" } ] } [/block]