Events API

Read-only access to your calendar events. This includes showings, synced Google Calendar events, and Cal.com bookings.

List Events


GET /api/v1/events

Returns events ordered by start time.

Query Parameters:

Parameter	Type	Description
`page`	number	Page number (default: 1)
`limit`	number	Items per page (default: 20)
`startAfter`	datetime	Only events starting after this time (ISO 8601)
`startBefore`	datetime	Only events starting before this time (ISO 8601)
`type`	string	Filter by type: `showing`, `call`, `inspection`, or `meeting`

Response:


{
  "data": [
    {
      "id": "550e8400-e29b-41d4-a716-446655440000",
      "type": "showing",
      "propertyId": "660e8400-e29b-41d4-a716-446655440000",
      "contactId": "770e8400-e29b-41d4-a716-446655440000",
      "title": "Showing: 123 Main St",
      "description": null,
      "startTime": "2026-02-15T14:00:00Z",
      "endTime": "2026-02-15T14:30:00Z",
      "timeZone": "America/New_York",
      "location": "123 Main St, Apt 4B",
      "status": "confirmed",
      "notes": null,
      "source": "internal",
      "reminderSentAt": null,
      "createdAt": "2026-02-10T10:00:00Z",
      "updatedAt": "2026-02-10T10:00:00Z"
    }
  ],
  "pagination": {
    "page": 1,
    "limit": 20,
    "total": 8,
    "totalPages": 1
  }
}

Notes

Read-only — to create showings, use the Showings API. Other event types are created via calendar sync.
source indicates where the event came from: internal (created in Rentalot), google_calendar, or calcom.
Use date range filters to fetch a specific week or month for calendar display.