# Calven Developer Docs ## Docs - [Overview](https://apidocs.calven.com/overview.md): - [Access Control](https://apidocs.calven.com/access-control.md): - [Basic Authentication Overview](https://apidocs.calven.com/basic-auth.md): - [HMAC Authentication Overview](https://apidocs.calven.com/hmac-auth.md): - [SDKs](https://apidocs.calven.com/sdks.md): - [Calven Data Models](https://apidocs.calven.com/data-models.md): - [Changelog](https://apidocs.calven.com/changelog.md): - Presence [Presence Overview](https://apidocs.calven.com/presence.md): - Occupancy [Occupancy Overview](https://apidocs.calven.com/occupancy.md): - Warehouse - Basic Auth [Warehouse API (Basic Auth)](https://apidocs.calven.com/warehouse-basic.md): - Warehouse - HMAC Auth [Warehouse API (HMAC Auth)](https://apidocs.calven.com/warehouse-hmac.md): - Hierarchy Information [Org Hierarchy Information Overview](https://apidocs.calven.com/org-hierarchy.md): - User Attributes [User Attributes Overview](https://apidocs.calven.com/user-attributes.md): ## API Docs - Authentication [Generate a token with an API key and HMAC](https://apidocs.calven.com/auth-hmac.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/auth-client-credentials.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/presence-hmac.md): Submit presence events to Calven. - Presence [Submit presence events (Basic auth)](https://apidocs.calven.com/presence-basic.md): Submit presence events to Calven. - Occupancy [Submit occupancy events](https://apidocs.calven.com/occupancy-hmac.md): Submit occupancy events to Calven. - Time Off [Submit time off updates](https://apidocs.calven.com/time-off.md): Submit time off updates to Calven. - Access Credentials [Submit access credentials](https://apidocs.calven.com/access-credentials.md): Submit access credentials to Calven. - Warehouse - Basic Auth [Users (Basic auth)](https://apidocs.calven.com/warehouse-users-basic.md): - Warehouse - Basic Auth [Groups (Basic auth)](https://apidocs.calven.com/warehouse-groups-basic.md): - Warehouse - Basic Auth [Locations (Basic auth)](https://apidocs.calven.com/warehouse-locations-basic.md): - Warehouse - Basic Auth [Desks (Basic auth)](https://apidocs.calven.com/warehouse-desks-basic.md): - Warehouse - Basic Auth [Bookings & Attendance (Basic auth)](https://apidocs.calven.com/warehouse-bookings-attendance-basic.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/warehouse-presence-basic.md): - Warehouse - Basic Auth [User Actions Log (Basic auth)](https://apidocs.calven.com/warehouse-user-actions-basic.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/warehouse-events-basic.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/warehouse-users-hmac.md): - Warehouse - HMAC Auth [Groups](https://apidocs.calven.com/warehouse-groups-hmac.md): - Warehouse - HMAC Auth [Locations](https://apidocs.calven.com/warehouse-locations-hmac.md): - Warehouse - HMAC Auth [Desks](https://apidocs.calven.com/warehouse-desks-hmac.md): - Warehouse - HMAC Auth [Bookings & Attendance](https://apidocs.calven.com/warehouse-bookings-attendance-hmac.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/warehouse-presence-hmac.md): - Warehouse - HMAC Auth [User Actions Log](https://apidocs.calven.com/warehouse-user-actions-hmac.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/warehouse-events-hmac.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/org-hierarchy-hmac.md): Submit group relationships for group hierarchy calculation in directory management. - Hierarchy Information [Submit group hierarchy relationships (Basic auth)](https://apidocs.calven.com/org-hierarchy-basic.md): Submit group relationships for group hierarchy calculation in directory management. - User Attributes [Write directory user attributes](https://apidocs.calven.com/user-attributes-hmac.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/user-attributes-basic.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/visitor-arrival-events-hmac.md): Submit visitor arrival events to Calven. - Visitor Management [Submit visitor arrival events (Basic auth)](https://apidocs.calven.com/visitor-arrival-events-basic.md): Submit visitor arrival events to Calven. - Parking [Retrieve parking bookings](https://apidocs.calven.com/parking-bookings-hmac.md): Retrieve parking bookings for a location on a given day. - Parking [Retrieve parking bookings (Basic auth)](https://apidocs.calven.com/parking-bookings-basic.md): Retrieve parking bookings for a location on a given day. ## Schemas - [DWEventsResponseDto](https://apidocs.calven.com/schema-17292852.md):