{"_id":"59a8dd6689fb2a002f85ff6b","project":"55c8cff571d7580d0063a5e5","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"},"category":{"_id":"59a8cfd3ead78a002d63cafe","project":"55c8cff571d7580d0063a5e5","version":"57624356653c2d2200fec79c","__v":0,"sync":{"url":"","isSync":false},"reference":false,"createdAt":"2017-09-01T03:11:15.280Z","from_sync":false,"order":28,"slug":"account-subaccount-pricing","title":"Account Subaccount Pricing"},"user":"56f99ab84d2b4f3400edb636","githubsync":"","__v":0,"parentDoc":null,"updates":[],"next":{"pages":[],"description":""},"createdAt":"2017-09-01T04:09:10.121Z","link_external":false,"link_url":"","sync_unique":"","hidden":false,"api":{"settings":"","results":{"codes":[]},"auth":"required","params":[],"url":""},"isReference":false,"order":0,"body":"This page gives an overview of how a Phone.com Master Account manages its pricing plan (coupon code) for its [Subaccounts](doc:subaccounts).\n[block:callout]\n{\n  \"type\": \"info\",\n  \"title\": \"API Token with Billing Scope\",\n  \"body\": \"Your Phone.com account API token must have Billing Scope enabled in order to use any of our pricing services.  Please contact [Support](http://support.phone.com/) if you need this.\"\n}\n[/block]\n## Supported Services\n* [List Pricing](doc:list-account-subaccount-pricing)\n* [Get Pricing](doc:get-account-subaccount-pricing)\n* [Create Pricing](doc:create-account-subaccount-pricing)\n* [Delete Pricing](doc:delete-account-subaccount-pricing)\n\n## Summary Object\n\nThe Pricing Summary Object is used to briefly represent a pricing plan. Here are the properties:\n[block:parameters]\n{\n  \"data\": {\n    \"h-0\": \"Property\",\n    \"h-1\": \"Description\",\n    \"h-2\": \"\",\n    \"0-0\": \"`id`\",\n    \"0-1\": \"Integer ID of this object.\",\n    \"0-2\": \"\",\n    \"1-0\": \"`pricing`\",\n    \"1-1\": \"[Pricing Object](#section-pricing-object)\",\n    \"1-2\": \"\",\n    \"2-0\": \"`voip_id`\",\n    \"2-1\": \"Phone.com API Account (VoIP) ID\",\n    \"3-0\": \"`reason`\",\n    \"3-1\": \"Reason this pricing plan is applied\",\n    \"4-0\": \"`who`\",\n    \"4-1\": \"Name of the person / process who added this pricing plan to the subaccount\",\n    \"5-0\": \"`expire_date`\",\n    \"5-1\": \"Pricing plan expiration timestamp in unix format. If pricing plan never expires, this item will not be returned\"\n  },\n  \"cols\": 2,\n  \"rows\": 6\n}\n[/block]\n## Pricing Object\n[block:parameters]\n{\n  \"data\": {\n    \"h-0\": \"Property\",\n    \"h-1\": \"Description\",\n    \"0-0\": \"`id`\",\n    \"1-0\": \"`name`\",\n    \"0-1\": \"Pricing code / ID\",\n    \"1-1\": \"Name of pricing plan\"\n  },\n  \"cols\": 2,\n  \"rows\": 2\n}\n[/block]\nHere's an example of the Pricing Summary Object:\n[block:code]\n{\n  \"codes\": [\n    {\n      \"code\": \"{\\n    \\\"id\\\": 4088030,\\n    \\\"pricing\\\": {\\n        \\\"id\\\": 525,\\n        \\\"name\\\": \\\"Phone.com coupon\\\"\\n    },\\n    \\\"voip_id\\\": 1329143,\\n    \\\"reason\\\": \\\"Test pricing code\\\",\\n    \\\"who\\\": \\\"API:Voip:349034\\\"\\n}\",\n      \"language\": \"json\"\n    }\n  ]\n}\n[/block]\n## Full Object\nThe Full Pricing Object is identical to the [Pricing Summary Object](#section-summary-object).","excerpt":"","slug":"account-subaccount-pricing","type":"basic","title":"Pricing"}
This page gives an overview of how a Phone.com Master Account manages its pricing plan (coupon code) for its [Subaccounts](doc:subaccounts). [block:callout] { "type": "info", "title": "API Token with Billing Scope", "body": "Your Phone.com account API token must have Billing Scope enabled in order to use any of our pricing services. Please contact [Support](http://support.phone.com/) if you need this." } [/block] ## Supported Services * [List Pricing](doc:list-account-subaccount-pricing) * [Get Pricing](doc:get-account-subaccount-pricing) * [Create Pricing](doc:create-account-subaccount-pricing) * [Delete Pricing](doc:delete-account-subaccount-pricing) ## Summary Object The Pricing Summary Object is used to briefly represent a pricing plan. Here are the properties: [block:parameters] { "data": { "h-0": "Property", "h-1": "Description", "h-2": "", "0-0": "`id`", "0-1": "Integer ID of this object.", "0-2": "", "1-0": "`pricing`", "1-1": "[Pricing Object](#section-pricing-object)", "1-2": "", "2-0": "`voip_id`", "2-1": "Phone.com API Account (VoIP) ID", "3-0": "`reason`", "3-1": "Reason this pricing plan is applied", "4-0": "`who`", "4-1": "Name of the person / process who added this pricing plan to the subaccount", "5-0": "`expire_date`", "5-1": "Pricing plan expiration timestamp in unix format. If pricing plan never expires, this item will not be returned" }, "cols": 2, "rows": 6 } [/block] ## Pricing Object [block:parameters] { "data": { "h-0": "Property", "h-1": "Description", "0-0": "`id`", "1-0": "`name`", "0-1": "Pricing code / ID", "1-1": "Name of pricing plan" }, "cols": 2, "rows": 2 } [/block] Here's an example of the Pricing Summary Object: [block:code] { "codes": [ { "code": "{\n \"id\": 4088030,\n \"pricing\": {\n \"id\": 525,\n \"name\": \"Phone.com coupon\"\n },\n \"voip_id\": 1329143,\n \"reason\": \"Test pricing code\",\n \"who\": \"API:Voip:349034\"\n}", "language": "json" } ] } [/block] ## Full Object The Full Pricing Object is identical to the [Pricing Summary Object](#section-summary-object).