# Calven Developer Docs ## Docs - [Overview](https://apidocs.calven.com/beta/doc-388244.md): - [SDKs](https://apidocs.calven.com/beta/doc-390417.md): - [Access Control](https://apidocs.calven.com/beta/doc-923294.md): - [HMAC Authentication Overview](https://apidocs.calven.com/beta/doc-923295.md): - [Basic Authentication Overview](https://apidocs.calven.com/beta/doc-923296.md): - [Calven Data Models](https://apidocs.calven.com/beta/doc-923297.md): - [Changelog](https://apidocs.calven.com/beta/doc-1598809.md): - Presence [Presence Overview](https://apidocs.calven.com/beta/doc-923298.md): - Occupancy [Occupancy Overview](https://apidocs.calven.com/beta/doc-923299.md): - Warehouse - Basic Auth [Warehouse API (Basic Auth)](https://apidocs.calven.com/beta/doc-923300.md): - Warehouse - HMAC Auth [Warehouse API (HMAC Auth)](https://apidocs.calven.com/beta/doc-923301.md): - Hierarchy Information [Org Hierarchy Information Overview](https://apidocs.calven.com/beta/doc-2118127.md): - User Attributes [User Attributes Overview](https://apidocs.calven.com/beta/doc-2135078.md): ## API Docs - Authentication [Generate a token with an API key and HMAC](https://apidocs.calven.com/beta/api-4769331.md): Generate a token with an API key and HMACSHA256. - Authentication [Generate a token with an API key and client secret](https://apidocs.calven.com/beta/api-4769332.md): Generate a token with an API key and client secret via an OAuth client credentials grant. - Presence [Submit presence events](https://apidocs.calven.com/beta/api-4769329.md): Submit presence events to Calven. - Presence [Submit presence events (Basic auth)](https://apidocs.calven.com/beta/api-6299588.md): Submit presence events to Calven. - Occupancy [Submit occupancy events](https://apidocs.calven.com/beta/api-4769330.md): Submit occupancy events to Calven. - Time Off [Submit time off updates](https://apidocs.calven.com/beta/api-4769607.md): Submit time off updates to Calven. - Access Credentials [Submit access credentials](https://apidocs.calven.com/beta/api-6545151.md): Submit access credentials to Calven. - Warehouse - Basic Auth [Users (Basic auth)](https://apidocs.calven.com/beta/api-15570732.md): - Warehouse - Basic Auth [Groups (Basic auth)](https://apidocs.calven.com/beta/api-21858979.md): - Warehouse - Basic Auth [Locations (Basic auth)](https://apidocs.calven.com/beta/api-15570733.md): - Warehouse - Basic Auth [Desks (Basic auth)](https://apidocs.calven.com/beta/api-15570734.md): - Warehouse - Basic Auth [Bookings & Attendance (Basic auth)](https://apidocs.calven.com/beta/api-15570735.md): The bookings and attendance query returns a combination of data from three different models: attendance, bookings and plans. It is recommended that you read the Calven Data Models overview to get more details on those. - Warehouse - Basic Auth [Presence (Basic auth)](https://apidocs.calven.com/beta/api-15570736.md): - Warehouse - Basic Auth [User Actions Log (Basic auth)](https://apidocs.calven.com/beta/api-15570737.md): The user action log contains events about user's plans and bookings. This information is helpful when investigating why a user may have been booked in a specific location. It is recommended that you are familiar with Calven's data model before utilizing this endpoint. Users have 2 related features - plans and bookings. When a user's plan is updated to/from the office, they will also have their booking updated. Because of this, you will often see pairs of events together that are triggered from the same system action. - Warehouse - Basic Auth [Events (Basic auth)](https://apidocs.calven.com/beta/api-42470273.md): Returns the events at your locations, one row per event, with each event's location, series, traits and participant response counts. The startDate and endDate parameters are required and set the report's date range. Each is compared against an event's own local date in its own timezone, not UTC, and the range cannot exceed 550 days. To narrow the results, pass eventSeriesIds, traitIds, locationIds or publishStatus as comma-separated lists. Returns up to 100 events at a time. To page through more, set limit to change the page size, up to 10000, and offset to skip to the next page. - Warehouse - HMAC Auth [Users](https://apidocs.calven.com/beta/api-15570738.md): - Warehouse - HMAC Auth [Groups](https://apidocs.calven.com/beta/api-21858978.md): - Warehouse - HMAC Auth [Locations](https://apidocs.calven.com/beta/api-15570739.md): - Warehouse - HMAC Auth [Desks](https://apidocs.calven.com/beta/api-15570740.md): - Warehouse - HMAC Auth [Bookings & Attendance](https://apidocs.calven.com/beta/api-15570741.md): The bookings and attendance query returns a combination of data from three different models: attendance, bookings and plans. It is recommended that you read the Calven Data Models overview to get more details on those. - Warehouse - HMAC Auth [Presence](https://apidocs.calven.com/beta/api-15570742.md): - Warehouse - HMAC Auth [User Actions Log](https://apidocs.calven.com/beta/api-15570743.md): The user action log contains events about user's plans and bookings. This information is helpful when investigating why a user may have been booked in a specific location. It is recommended that you are familiar with Calven's data model before utilizing this endpoint. Users have 2 related features - plans and bookings. When a user's plan is updated to/from the office, they will also have their booking updated. Because of this, you will often see pairs of events together that are triggered from the same system action. - Warehouse - HMAC Auth [Events](https://apidocs.calven.com/beta/api-42470272.md): Returns the events at your locations, one row per event, with each event's location, series, traits and participant response counts. The startDate and endDate parameters are required and set the report's date range. Each is compared against an event's own local date in its own timezone, not UTC, and the range cannot exceed 550 days. To narrow the results, pass eventSeriesIds, traitIds, locationIds or publishStatus as comma-separated lists. Returns up to 100 events at a time. To page through more, set limit to change the page size, up to 10000, and offset to skip to the next page. - Hierarchy Information [Submit group hierarchy relationships](https://apidocs.calven.com/beta/api-34555229.md): Submit group relationships for group hierarchy calculation in directory management. - Hierarchy Information [Submit group hierarchy relationships (Basic auth)](https://apidocs.calven.com/beta/api-34555230.md): Submit group relationships for group hierarchy calculation in directory management. - User Attributes [Write directory user attributes](https://apidocs.calven.com/beta/api-35108155.md): Write attribute name/value pairs to directory user documents under the Calven internal namespace. - User Attributes [Write directory user attributes (Basic auth)](https://apidocs.calven.com/beta/api-35108156.md): Write attribute name/value pairs to directory user documents under the Calven internal namespace. - Visitor Management [Submit visitor arrival events](https://apidocs.calven.com/beta/api-41217583.md): Submit visitor arrival events to Calven. - Visitor Management [Submit visitor arrival events (Basic auth)](https://apidocs.calven.com/beta/api-41217584.md): Submit visitor arrival events to Calven. - Parking [Retrieve parking bookings](https://apidocs.calven.com/beta/api-41217585.md): Retrieve parking bookings for a location on a given day. - Parking [Retrieve parking bookings (Basic auth)](https://apidocs.calven.com/beta/api-41217586.md): Retrieve parking bookings for a location on a given day. - Service Requests [Service Offerings](https://apidocs.calven.com/beta/api-45452416.md): Returns the current version of every Service Offering you can request, such as room requests and catering, optionally for one location. - Service Requests [Service Offering](https://apidocs.calven.com/beta/api-45452417.md): Returns one Service Offering version with the questions a request for it answers. Returns 404 when the Offering does not exist in your tenant. - Service Requests [Submit a service request](https://apidocs.calven.com/beta/api-45452418.md): Creates a Service Request for a person outside your organisation and links it to a meeting. Send meeting to have Calven book the meeting in the location room-requests calendar, which only a room request can do, or calendarEventId to link the request to an existing Calven calendar event, such as the one returned when you submitted the room request. - Service Requests [Service Request](https://apidocs.calven.com/beta/api-45452419.md): Returns a Service Request and its current status. Only requests raised with the same API key are returned; any other ID returns 404. - Service Requests [Update a service request](https://apidocs.calven.com/beta/api-45452420.md): Changes the answers or the required time of a Service Request and returns the updated request. Fields you leave out keep their value. Only requests raised with the same API key can be updated; any other ID returns 404. ## Schemas - [DWEventsResponseDto](https://apidocs.calven.com/beta/schema-17292852.md):