{"activeVersionTag":"latest","latestAvailableVersionTag":"latest","collection":{"info":{"_postman_id":"a2ccf0df-28ad-40a9-afe3-f0742c7e308f","name":"VergeSense API","description":"There are two ways to interact with VergeSense’s APIs: VergeSense can set up pre-packaged [Webhooks](https://vergesense.readme.io/reference/web-hooks) to automatically “push” relevant data to your platform, enabling greater customization. Or, you can use VergeSense’s [REST](https://en.wikipedia.org/wiki/Representational_state_transfer) / Analytics API to “pull” the data you need.\n\nWebhooks are the preferred way to get a stream of real time data, for example, for every sensor, room, point in time, or a person count in a given space. When using webhooks, the data is pushed to your platform where you can perform further analysis.\n\n<img src=\"https://content.pstmn.io/75ef6fdf-793e-4578-9630-1772948b6033/aW1hZ2UucG5n\" width=\"1076\" height=\"636\">\n\nSome use cases for webhooks:\n\n- Indicate availability of rooms in real time. For example, you have a kiosk in your lobby and want to know when rooms are available.\n    \n- Integrate with business intelligence dashboards. For example, Robin Powered or an Integrated Workplace Management System (IWMS) of your choosing.\n    \n\nMeanwhile, the REST API is useful for getting specific or historical metadata from a point in time. When using the REST API, VergeSense stores the data and performs the analysis for you to conveniently access.\n\nA use case for the REST API:\n\n- Building a historical report. For example, you want to generate a report for Building 1, Floor 3 to determine how busy Conference Room B was in the month of February.\n    \n\n## Setup\n\nTo get an API key, contact `support@vergesense.com` to request a VergeSense Admin account.\n\nOnce you have a VergeSense Admin account, navigate to Integrations and click Generate API Key.\n\n<img src=\"https://files.readme.io/2ed10b9-Generate_API_Key_1.png\">\n\nOn the popup screen, enter an API Token Name, select buildings to which the API key applies, then click Save.\n\n<img src=\"https://files.readme.io/9085977-Generate_API_Key_2.png\">\n\nTo view or modify the API key, navigate to Integrations and click Details.\n\n<img src=\"https://files.readme.io/7d035d6-Generate_API_Key_3.png\">\n\nFrom the Details screen, you can\n\n- edit the API Token Name,\n    \n- click the eye icon to view the API key,\n    \n- select buildings to which the API key applies, or\n    \n- click Rotate to generate a new API key.\n    \n\nYour organization may choose to periodically rotate the API key for enhanced security or in the event the API key was compromised.\n\n<img src=\"https://files.readme.io/9105acf-Generate_API_Key_4.png\">\n\n## Requests\n\nAPIs request allows you to retrieve data from a data source or to send data. API requests should be made to the following endpoints depending on the deployment environment:  \n**AWS** (default): `https://api.vergesense.com`  \n**Azure**: `https://api.azure.vergesense.com`\n\n## Authentication\n\nAPI endpoints are authenticated via the API key. Once you have an API key, you must use the HTTP header `vs-api-key`. Otherwise, a `403: Forbidden` error will be returned. All requests must use `https://`. Requests made to `http://` will not be accepted.\n\n## Error Codes\n\n**400 Bad Request**  \nInvalid request sent to API. Additional information appears in the response body.\n\n**403 Forbidden**  \nCaused by a missing HTTP header or invalid API token.\n\n**404 Not Found**  \nThe requested resource does not exist.\n\n**409 Conflict**  \nThe request conflicts with another request.\n\n## Timestamps\n\n[Timestamps](https://en.wikipedia.org/wiki/Timestamp) should be specified in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format.\n\nThe following formats are both valid: `2019-01-15T23:30:28-08:00` and `2019-01-15T23:30:28Z`.\n\nTimestamps will be returned in ISO 8601 UTC format, for example: `2019-01-15T23:30:28Z`.\n\n[Timestamp Formatting Tool](https://www.timestamp-converter.com/)\n\n## Timeouts and Rate Limiting\n\nAPI requests will timeout after 30 seconds. If your requests are timing out, use an appropriate filter to reduce the result set and the time required to calculate a response.\n\nA rate limit of 120 requests per minute is enforced across all API endpoints based on the source IP address.\n\n## API Changes\n\nAPI changes will be published on our public facing [changelog](https://headwayapp.co/headway-changelog). Through the changelog VergeSense will publish information regarding new endpoints, improvements, and deprecations.\n\n### RSS Feed\n\nAn RSS feed of the changelog is available using this URL: [https://headwayapp.co/vergesense-changelog/rss](https://headwayapp.co/vergesense-changelog/rss)\n\n## Versioning\n\nAt VergeSense we use a `YYYY-MM-DD` format to version our APIs. The first time you make a request to our API we will set your API version to the most recent version. Optionally, if you'd like to use a different version of the API, you can use the `vs-version` request header. This document is for version `2017-06-14`. The current version of the API is `2019-04-17`. To find a full list of versions along with their respective changes, please see our [ChangeLog](https://headwayapp.co/vergesense-changelog/).","schema":"https://schema.getpostman.com/json/collection/v2.0.0/collection.json","isPublicCollection":false,"owner":"6835591","team":748208,"collectionId":"a2ccf0df-28ad-40a9-afe3-f0742c7e308f","publishedId":"2s9Y5Wx3QL","public":true,"publicUrl":"https://documenter-api.postman.tech/view/6835591/2s9Y5Wx3QL","privateUrl":"https://go.postman.co/documentation/6835591-a2ccf0df-28ad-40a9-afe3-f0742c7e308f","customColor":{"top-bar":"FFFFFF","right-sidebar":"303030","highlight":"704FFB"},"documentationLayout":"classic-double-column","customisation":{"metaTags":[{"name":"description","value":""},{"name":"title","value":""}],"appearance":{"default":"light","themes":[{"name":"dark","logo":"https://content.pstmn.io/033b3022-9755-40e0-a628-542a0fd56d37/VmVyZ2VTZW5zZV9Mb2dvX1B1cnBsZSgxKS5wbmc=","colors":{"top-bar":"212121","right-sidebar":"303030","highlight":"704FFB"}},{"name":"light","logo":"https://content.pstmn.io/033b3022-9755-40e0-a628-542a0fd56d37/VmVyZ2VTZW5zZV9Mb2dvX1B1cnBsZSgxKS5wbmc=","colors":{"top-bar":"FFFFFF","right-sidebar":"303030","highlight":"704FFB"}}]}},"version":"8.10.0","publishDate":"2023-08-24T15:59:20.000Z","activeVersionTag":"latest","documentationTheme":"light","metaTags":{"title":"","description":""},"logos":{"logoLight":"https://content.pstmn.io/033b3022-9755-40e0-a628-542a0fd56d37/VmVyZ2VTZW5zZV9Mb2dvX1B1cnBsZSgxKS5wbmc=","logoDark":"https://content.pstmn.io/033b3022-9755-40e0-a628-542a0fd56d37/VmVyZ2VTZW5zZV9Mb2dvX1B1cnBsZSgxKS5wbmc="}},"statusCode":200},"environments":[],"user":{"authenticated":false,"permissions":{"publish":false}},"run":{"button":{"js":"https://run.pstmn.io/button.js","css":"https://run.pstmn.io/button.css"}},"web":"https://www.getpostman.com/","team":{"logo":"https://res.cloudinary.com/postman/image/upload/t_team_logo_pubdoc/v1/team/dc257519dadb4682c67624a6c8a75a3f06acee1e09f790ec31a682fd20be1372","favicon":""},"isEnvFetchError":false,"languages":"[{\"key\":\"csharp\",\"label\":\"C#\",\"variant\":\"HttpClient\"},{\"key\":\"csharp\",\"label\":\"C#\",\"variant\":\"RestSharp\"},{\"key\":\"curl\",\"label\":\"cURL\",\"variant\":\"cURL\"},{\"key\":\"dart\",\"label\":\"Dart\",\"variant\":\"http\"},{\"key\":\"go\",\"label\":\"Go\",\"variant\":\"Native\"},{\"key\":\"http\",\"label\":\"HTTP\",\"variant\":\"HTTP\"},{\"key\":\"java\",\"label\":\"Java\",\"variant\":\"OkHttp\"},{\"key\":\"java\",\"label\":\"Java\",\"variant\":\"Unirest\"},{\"key\":\"javascript\",\"label\":\"JavaScript\",\"variant\":\"Fetch\"},{\"key\":\"javascript\",\"label\":\"JavaScript\",\"variant\":\"jQuery\"},{\"key\":\"javascript\",\"label\":\"JavaScript\",\"variant\":\"XHR\"},{\"key\":\"c\",\"label\":\"C\",\"variant\":\"libcurl\"},{\"key\":\"nodejs\",\"label\":\"NodeJs\",\"variant\":\"Axios\"},{\"key\":\"nodejs\",\"label\":\"NodeJs\",\"variant\":\"Native\"},{\"key\":\"nodejs\",\"label\":\"NodeJs\",\"variant\":\"Request\"},{\"key\":\"nodejs\",\"label\":\"NodeJs\",\"variant\":\"Unirest\"},{\"key\":\"objective-c\",\"label\":\"Objective-C\",\"variant\":\"NSURLSession\"},{\"key\":\"ocaml\",\"label\":\"OCaml\",\"variant\":\"Cohttp\"},{\"key\":\"php\",\"label\":\"PHP\",\"variant\":\"cURL\"},{\"key\":\"php\",\"label\":\"PHP\",\"variant\":\"Guzzle\"},{\"key\":\"php\",\"label\":\"PHP\",\"variant\":\"HTTP_Request2\"},{\"key\":\"php\",\"label\":\"PHP\",\"variant\":\"pecl_http\"},{\"key\":\"powershell\",\"label\":\"PowerShell\",\"variant\":\"RestMethod\"},{\"key\":\"python\",\"label\":\"Python\",\"variant\":\"http.client\"},{\"key\":\"python\",\"label\":\"Python\",\"variant\":\"Requests\"},{\"key\":\"r\",\"label\":\"R\",\"variant\":\"httr\"},{\"key\":\"r\",\"label\":\"R\",\"variant\":\"RCurl\"},{\"key\":\"ruby\",\"label\":\"Ruby\",\"variant\":\"Net::HTTP\"},{\"key\":\"shell\",\"label\":\"Shell\",\"variant\":\"Httpie\"},{\"key\":\"shell\",\"label\":\"Shell\",\"variant\":\"wget\"},{\"key\":\"swift\",\"label\":\"Swift\",\"variant\":\"URLSession\"}]","languageSettings":[{"key":"csharp","label":"C#","variant":"HttpClient"},{"key":"csharp","label":"C#","variant":"RestSharp"},{"key":"curl","label":"cURL","variant":"cURL"},{"key":"dart","label":"Dart","variant":"http"},{"key":"go","label":"Go","variant":"Native"},{"key":"http","label":"HTTP","variant":"HTTP"},{"key":"java","label":"Java","variant":"OkHttp"},{"key":"java","label":"Java","variant":"Unirest"},{"key":"javascript","label":"JavaScript","variant":"Fetch"},{"key":"javascript","label":"JavaScript","variant":"jQuery"},{"key":"javascript","label":"JavaScript","variant":"XHR"},{"key":"c","label":"C","variant":"libcurl"},{"key":"nodejs","label":"NodeJs","variant":"Axios"},{"key":"nodejs","label":"NodeJs","variant":"Native"},{"key":"nodejs","label":"NodeJs","variant":"Request"},{"key":"nodejs","label":"NodeJs","variant":"Unirest"},{"key":"objective-c","label":"Objective-C","variant":"NSURLSession"},{"key":"ocaml","label":"OCaml","variant":"Cohttp"},{"key":"php","label":"PHP","variant":"cURL"},{"key":"php","label":"PHP","variant":"Guzzle"},{"key":"php","label":"PHP","variant":"HTTP_Request2"},{"key":"php","label":"PHP","variant":"pecl_http"},{"key":"powershell","label":"PowerShell","variant":"RestMethod"},{"key":"python","label":"Python","variant":"http.client"},{"key":"python","label":"Python","variant":"Requests"},{"key":"r","label":"R","variant":"httr"},{"key":"r","label":"R","variant":"RCurl"},{"key":"ruby","label":"Ruby","variant":"Net::HTTP"},{"key":"shell","label":"Shell","variant":"Httpie"},{"key":"shell","label":"Shell","variant":"wget"},{"key":"swift","label":"Swift","variant":"URLSession"}],"languageOptions":[{"label":"C# - HttpClient","value":"csharp - HttpClient - C#"},{"label":"C# - RestSharp","value":"csharp - RestSharp - C#"},{"label":"cURL - cURL","value":"curl - cURL - cURL"},{"label":"Dart - http","value":"dart - http - Dart"},{"label":"Go - Native","value":"go - Native - Go"},{"label":"HTTP - HTTP","value":"http - HTTP - HTTP"},{"label":"Java - OkHttp","value":"java - OkHttp - Java"},{"label":"Java - Unirest","value":"java - Unirest - Java"},{"label":"JavaScript - Fetch","value":"javascript - Fetch - JavaScript"},{"label":"JavaScript - jQuery","value":"javascript - jQuery - JavaScript"},{"label":"JavaScript - XHR","value":"javascript - XHR - JavaScript"},{"label":"C - libcurl","value":"c - libcurl - C"},{"label":"NodeJs - Axios","value":"nodejs - Axios - NodeJs"},{"label":"NodeJs - Native","value":"nodejs - Native - NodeJs"},{"label":"NodeJs - Request","value":"nodejs - Request - NodeJs"},{"label":"NodeJs - Unirest","value":"nodejs - Unirest - NodeJs"},{"label":"Objective-C - NSURLSession","value":"objective-c - NSURLSession - Objective-C"},{"label":"OCaml - Cohttp","value":"ocaml - Cohttp - OCaml"},{"label":"PHP - cURL","value":"php - cURL - PHP"},{"label":"PHP - Guzzle","value":"php - Guzzle - PHP"},{"label":"PHP - HTTP_Request2","value":"php - HTTP_Request2 - PHP"},{"label":"PHP - pecl_http","value":"php - pecl_http - PHP"},{"label":"PowerShell - RestMethod","value":"powershell - RestMethod - PowerShell"},{"label":"Python - http.client","value":"python - http.client - Python"},{"label":"Python - Requests","value":"python - Requests - Python"},{"label":"R - httr","value":"r - httr - R"},{"label":"R - RCurl","value":"r - RCurl - R"},{"label":"Ruby - Net::HTTP","value":"ruby - Net::HTTP - Ruby"},{"label":"Shell - Httpie","value":"shell - Httpie - Shell"},{"label":"Shell - wget","value":"shell - wget - Shell"},{"label":"Swift - URLSession","value":"swift - URLSession - Swift"}],"layoutOptions":[{"value":"classic-single-column","label":"Single Column"},{"value":"classic-double-column","label":"Double Column"}],"versionOptions":[],"environmentOptions":[{"value":"0","label":"No Environment"}],"canonicalUrl":"https://documenter.gw.postman.com/view/metadata/2s9Y5Wx3QL"}