{"metadata":{"image":[],"title":"","description":""},"api":{"url":"","auth":"required","params":[],"results":{"codes":[]},"settings":""},"next":{"description":"","pages":[]},"title":"Introduction","type":"basic","slug":"introduction","excerpt":"","body":"We designed this API as a JSON-based REST API to make integration easy.  For a very basic test, try loading our base URL, [https://api.phone.com/v4](https://api.phone.com/v4), in your web browser.\n\nPart of being a REST API is including links and other metadata in our response bodies.  This means our API is partially _self-documenting_.  By default, our response bodies include whitespace to make them more human-readable.  We also feature judicious use of metadata and context-sensitive links to inform you about related resources.  We format these using the [Mason, draft 2](https://github.com/JornWildt/Mason/blob/master/Documentation/Mason-draft-2.md) specification.\n[block:callout]\n{\n  \"type\": \"info\",\n  \"title\": \"Which API again?\",\n  \"body\": \"Note that this website refers to our new API, codenamed \\\"Phoenix\\\", which we launched in the Spring of 2016.  If you were a Phone.com customer prior to this, you might be looking for our earlier [XML API](https://www.phone.com/api) or maybe our [V1 \\\"REST\\\" API](http://docs.phone.com).  Confusing? Yeah, we know.  Both of these will eventually be retired as we finish adding the same functionalities here. Don't worry, though. We'll notify you well in advance of taking them offline.\"\n}\n[/block]","updates":["57928be169c5120e00efdeed","5792931390ad641700d46bbe"],"order":1,"isReference":false,"hidden":false,"sync_unique":"","link_url":"","link_external":false,"_id":"57624356653c2d2200fec7d6","project":"55c8cff571d7580d0063a5e5","user":"55c8cf9471d7580d0063a5e4","category":{"sync":{"isSync":false,"url":""},"pages":[],"title":"Getting Started","slug":"documentation","order":0,"from_sync":false,"reference":false,"_id":"57624356653c2d2200fec79d","project":"55c8cff571d7580d0063a5e5","__v":0,"version":"57624356653c2d2200fec79c","createdAt":"2015-08-10T16:23:18.580Z"},"createdAt":"2016-03-14T16:17:30.298Z","githubsync":"","__v":8,"parentDoc":null,"version":{"version":"4","version_clean":"4.0.0","codename":"","is_stable":true,"is_beta":true,"is_hidden":false,"is_deprecated":false,"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","5ba8fd1a4c8c220003a08f0f","5ede526e75bc22005d0adecc"],"_id":"57624356653c2d2200fec79c","createdAt":"2016-06-16T06:12:38.244Z","releaseDate":"2016-06-16T06:12:38.244Z","__v":23,"project":"55c8cff571d7580d0063a5e5"}}
We designed this API as a JSON-based REST API to make integration easy. For a very basic test, try loading our base URL, [https://api.phone.com/v4](https://api.phone.com/v4), in your web browser. Part of being a REST API is including links and other metadata in our response bodies. This means our API is partially _self-documenting_. By default, our response bodies include whitespace to make them more human-readable. We also feature judicious use of metadata and context-sensitive links to inform you about related resources. We format these using the [Mason, draft 2](https://github.com/JornWildt/Mason/blob/master/Documentation/Mason-draft-2.md) specification. [block:callout] { "type": "info", "title": "Which API again?", "body": "Note that this website refers to our new API, codenamed \"Phoenix\", which we launched in the Spring of 2016. If you were a Phone.com customer prior to this, you might be looking for our earlier [XML API](https://www.phone.com/api) or maybe our [V1 \"REST\" API](http://docs.phone.com). Confusing? Yeah, we know. Both of these will eventually be retired as we finish adding the same functionalities here. Don't worry, though. We'll notify you well in advance of taking them offline." } [/block]