Calven
  1. Warehouse - HMAC Auth
Calven
  • Overview
  • Key Access Levels
  • Basic Authentication Overview
  • HMAC Authentication Overview
  • SDKs
  • Calven Data Models
  • HMAC Authentication
    • Generate a token with an API key and HMAC
      POST
    • Generate a token with an API key and client secret
      POST
  • Presence
    • Presence Overview
    • Submit presence events with BASIC auth
      POST
    • Submit presence events
      POST
  • Occupancy
    • Occupancy Overview
    • Submit occupancy events
      POST
  • Time off
    • Submit time off updates
      POST
  • Access Credentials
    • Submit access credentials
      POST
  • Warehouse - Basic Auth
    • Warehouse Overview
    • Users
      GET
    • Locations
      GET
    • Desks
      GET
    • Bookings & Attendance
      GET
    • Presence Details
      GET
    • User Actions Log
      GET
  • Warehouse - HMAC Auth
    • Warehouse Overview
    • Users
      GET
    • Locations
      GET
    • Desks
      GET
    • Bookings & Attendance
      GET
    • Presence
      GET
    • User Actions Log
      GET
  1. Warehouse - HMAC Auth

Desks

GET
/v1/analytics/desks
analytics

Request

Authorization
Provide your bearer token in the
Authorization
header when making requests to protected resources.
Example:
Authorization: Bearer ********************
Query Params
locationId
string 
required
Location Id to query data for
Example:
3a2b0fd7-5f5a-4472-ab61-a2cc1784d38b

Request samples

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request GET 'https://api.calven.com/v1/analytics/desks?locationId'

Responses

🟢200OK
application/json
Body
array of:
assignedUserId
object 
required
The uid of a user assigned to the desk
Example:
3a2b0fd7-5f5a-4472-ab61-a2cc1784d38b
assignedUserName
object 
required
The userName of a user assigned to the desk
Example:
johndoe@calven.com
levelId
string 
required
The levelId of the desk
Example:
3a2b0fd7-5f5a-4472-ab61-a2cc1784d38b
levelName
string 
required
The level name of the desk
Example:
Level 1
placeId
string 
required
The placeId of the desk
Example:
3a2b0fd7-5f5a-4472-ab61-a2cc1784d38b
placeName
string 
required
The name of the desk
Example:
Main Office
type
enum<string> 
required
The desk type
Allowed values:
assigneddisabledshared
Example:
assigned
zoneId
string 
required
The zoneId of the desk
Example:
3a2b0fd7-5f5a-4472-ab61-a2cc1784d38b
zoneName
string 
required
The zone name of the desk
Example:
Zone A
Example
[
    {
        "assignedUserId": "3a2b0fd7-5f5a-4472-ab61-a2cc1784d38b",
        "assignedUserName": "johndoe@calven.com",
        "levelId": "3a2b0fd7-5f5a-4472-ab61-a2cc1784d38b",
        "levelName": "Level 1",
        "placeId": "3a2b0fd7-5f5a-4472-ab61-a2cc1784d38b",
        "placeName": "Main Office",
        "type": "assigned",
        "zoneId": "3a2b0fd7-5f5a-4472-ab61-a2cc1784d38b",
        "zoneName": "Zone A"
    }
]
Modified at 2025-04-03 13:54:25
Previous
Locations
Next
Bookings & Attendance
Built with