List calendar events

​

Returns a list of calendar events for the authenticated project. Results are paginated using cursor pagination.

Query Parameters

  • calendar_deduplication_key
    Type: string

    Filter events by calendar deduplication key

  • calendar_id
    Type: string

    Filter events by calendar ID

  • cursor
    Type: string

    Cursor for pagination

  • end_time_lte
    Type: string

    Filter events with end_time at or before this timestamp (ISO 8601 format)

  • event_id
    Type: string

    Filter events by event ID

  • ordering
    Type: stringenum

    Order results by field. Use '-' prefix for descending order. Default: -updated_at.

    values
    -created_at-end_time-start_time-updated_atcreated_atend_timestart_timeupdated_at
  • start_time_gte
    Type: string

    Filter events with start_time at or after this timestamp (ISO 8601 format)

  • updated_after
    Type: string
    deprecated

    Deprecated: Use updated_at_gte instead. Alias for updated_at_gte, kept for backwards compatibility.

  • updated_at_gte
    Type: string

    Filter events updated at or after this timestamp (ISO 8601 format)

Headers

  • Authorization
    Type: string
    required

    API key for authentication

  • Content-Type
    Type: string
    required

    Should always be application/json

Responses

  • application/json
Request Example for get/api/v1/calendar_events
curl 'https://app.attendee.dev/api/v1/calendar_events?calendar_deduplication_key=user-abcd&calendar_id=cal_abcdef1234567890&end_time_lte=2025-01-13T18%3A00%3A00Z&event_id=evt_abcdef1234567890&ordering=start_time&start_time_gte=2025-01-13T10%3A30%3A00Z&updated_at_gte=2025-01-13T10%3A30%3A00Z' \
  --header 'Authorization: Token YOUR_API_KEY_HERE' \
  --header 'Content-Type: application/json'
Calendar Event

Example of a calendar event with associated bots

{
  "next": "http://api.example.org/accounts/?cursor=cD00ODY%3D\"",
  "previous": "http://api.example.org/accounts/?cursor=cj0xJnA9NDg3",
  "results": [
    {
      "id": "evt_abcdef1234567890",
      "calendar_id": "cal_abcdef1234567890",
      "platform_uuid": "google_event_123456789",
      "meeting_url": "https://meet.google.com/abc-defg-hij",
      "name": "Event Name",
      "start_time": "2025-01-15T14:00:00Z",
      "end_time": "2025-01-15T15:00:00Z",
      "is_deleted": false,
      "attendees": [
        {
          "email": "user1@example.com",
          "name": "John Doe"
        },
        {
          "email": "user2@example.com",
          "name": "Jane Smith"
        }
      ],
      "raw": {
        "google_event_data": "..."
      },
      "bots": [
        {
          "id": "bot_abcdef1234567890",
          "metadata": {
            "customer_id": "abc123"
          },
          "meeting_url": "https://meet.google.com/abc-defg-hij",
          "state": "joined_recording",
          "events": [],
          "transcription_state": "complete",
          "recording_state": "complete",
          "join_at": "2025-01-15T14:00:00Z"
        }
      ],
      "created_at": "2025-01-13T10:30:00.123456Z",
      "updated_at": "2025-01-13T10:30:00.123456Z"
    }
  ]
}

List of calendar events