1. Warehouse - Basic Auth
Calven Developer Docs
  • Overview
  • Key Access Levels
  • Basic Authentication Overview
  • HMAC Authentication Overview
  • SDKs
  • Calven Data Models
  • Changelog
  • 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
      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
    • Groups
      GET
    • Locations
      GET
    • Desks
      GET
    • Events
      GET
    • Bookings & Attendance
      GET
    • Presence
      GET
    • User Actions Log
      GET
  • Warehouse - HMAC Auth
    • Warehouse Overview
    • Users
    • Groups
    • Locations
    • Desks
    • Events
    • Bookings & Attendance
    • Presence
    • User Actions Log
  • Hierarchy Information
    • Org Hierarchy Information Overview
    • Submit group hierarchy relationships
    • Submit group hierarchy relationships
  • User Attributes
    • User Attributes Overview
    • Write directory user attributes
    • Write directory user attributes
  • Visitor Management
    • Submit visitor arrival events
    • Submit visitor arrival events
  • Parking
    • Retrieve parking bookings
    • Retrieve parking bookings
  • Schemas
    • Schemas
      • LeaveRequestBody
      • TimeoffRequestBody
      • TimeOffEvent
      • TimeoffResponse
      • TimeoffEventResponse
    • DMPostUserAttributesRecordDto
    • DMPostUserAttributesBodyDto
    • SourceEventResultCode
    • SourceEventResultDto
    • DMPostUserAttributesResponseDto
    • ApiServiceException
    • VisitorArrivalEventDto
    • DWLocationsResponseDto
    • DWChangeLogUserResponseDto
    • DWUsersResponseDto
    • PresenceEventDto
    • DWUserBookingAttendanceResponseDto
    • DWPresenceResponseDto
    • DWDesksResponseDto
    • DWGroupsResponseDto
    • DMGroupRelationshipDto
    • DMPostUserAttributesRecordResponseDto
    • CreateVisitorArrivalEventResponseDto
    • OccupancyEventDto
    • CreatePresenceEventDto
    • EventResultDto
    • CreatePresenceEventResponseDto
    • ResultCodes
    • CreateOccupancyEventDto
    • CreateOccupancyEventResponseDto
    • AuthRequestDto
    • AuthResponseDto
    • OAuthResponseDto
    • AccessCredentialUpdateRequest
    • AccessCredentialUpdate
    • AccessCredential
    • AccessCredentialUpdateResponse
    • AccessCredentialUpdateResult
    • AccessCredentialUpdateResultCodes
    • OAuthRequestDto
    • CreateVisitorArrivalEventDto
    • DWEventsResponseDto
    • TimeOffRequestBodyDto
    • TimeOffResponseDto
    • PutDMGroupHierarchyRelationshipBodyDto
    • ParkingBookingReportPrincipalDto
    • ParkingBookingReportSpotDto
    • ParkingBookingReportZoneDto
    • ParkingBookingReportAreaDto
    • GetParkingBookingReportResponseDto
  1. Warehouse - Basic Auth

Events

GET
/v1/analytics/events/basic
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.

Request

Authorization
Send your HTTP requests with an
Authorization
header that contains the word Basic followed by a space and a base64-encoded string username:password
Example:
Authorization: Basic *****************
Query Params

Request Code 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 'https://api.calven.com/v1/analytics/events/basic?endDate=undefined&eventSeriesIds=undefined&locationIds=undefined&publishStatus=undefined&startDate=undefined&traitIds=undefined&limit=undefined&offset=undefined' \
--header 'Authorization: Basic <encoded-value>'

Responses

🟢200OK
application/json
Bodyapplication/json

Example
[
    {
        "accepted": 12,
        "acceptedPhysical": 8,
        "acceptedRemote": 4,
        "durationMinutes": 60,
        "endTime": "2023-12-31T04:30:00.000Z",
        "eventCategory": "Team lunches",
        "eventDate": "2023-12-31T00:00:00.000Z",
        "eventId": "3a2b0fd7-5f5a-4472-ab61-a2cc1784d38b",
        "eventName": "Beach clean up",
        "eventSeriesId": "3a2b0fd7-5f5a-4472-ab61-a2cc1784d38b",
        "eventTime": "14:30",
        "locationId": "3a2b0fd7-5f5a-4472-ab61-a2cc1784d38b",
        "locationTitle": "Level 3, Meeting Room 2",
        "noResponse": 17,
        "office": "Main Office",
        "onlineCapacity": 100,
        "participantCount": 40,
        "physicalCapacity": 25,
        "physicalLocationType": "none",
        "publishStatus": "archived",
        "rejected": 1,
        "remoteLocationType": "googleHangouts",
        "startTime": "2023-12-31T03:30:00.000Z",
        "tentative": 2,
        "timezone": "Australia/Sydney",
        "traitIds": [
            "3a2b0fd7-5f5a-4472-ab61-a2cc1784d38b"
        ],
        "traitLabels": [
            "Volunteering"
        ]
    }
]
🟠401Unauthorized
Modified at 2026-08-27 06:13:27
Previous
Desks
Next
Bookings & Attendance
Built with