> ## Documentation Index
> Fetch the complete documentation index at: https://docs.flashquotes.com/llms.txt
> Use this file to discover all available pages before exploring further.

# List Events (Legacy)

> Legacy date-range list endpoint — use List Events for new integrations

<Warning>
  **Deprecated.** This endpoint returns the original wrapped response shape and is capped at a 7-day window. It is maintained for backwards compatibility only. For new integrations, use [`GET /events`](/api-reference/event/list-events), which supports cursor pagination, broader date-range filters, equality filters, and `expand[]` for related objects.
</Warning>

This endpoint returns a list of events that fall within the specified date range. You can optionally filter events by location.

### Response

The response includes an array of event objects containing:

* Event identification and basic details
* Location information (venue name, address)
* Assigned resources (equipment, machines)
* Staff assignments
* Associated addons
* Booking status and details
* Event brief reference

### Common Use Cases

* Retrieving events for a specific time period
* Checking event schedules by location
* Planning resource and staff allocation
* Reviewing upcoming bookings
* Generating event reports

### Notes

* Date ranges must be provided in ISO 8601 format with timezone offset (e.g., `2024-01-01T00:00:00-05:00`)
* **Maximum date range span is 7 days**
* Results are ordered by event start time
* Returns a 400 error if date format is invalid or date range exceeds 7 days
* Responses are wrapped in an array envelope
* Access requires a valid API key with appropriate permissions

### Migrating to `GET /events`

The new endpoint uses Stripe-style range filters and cursor pagination instead of a single required date range:

| Legacy parameter                 | v2 equivalent                                                                 |
| -------------------------------- | ----------------------------------------------------------------------------- |
| `event_starts_after` (required)  | `service_start_time[gte]` (optional)                                          |
| `event_starts_before` (required) | `service_start_time[lt]` (optional)                                           |
| (7-day cap)                      | No range cap — use `limit` (default 10, max 100) and `starting_after` to page |
| `location` filter                | `location_id` query parameter                                                 |

The response is the standard list envelope (`{ object: "list", url, hasMore, data }`) rather than the legacy wrapped array.


## OpenAPI

````yaml GET /event/get-events
openapi: 3.0.1
info:
  title: Flashquotes API
  description: API for accessing event, form, and invoice data from Flashquotes
  version: 1.0.0
  contact:
    name: Flashquotes Support
    email: support@flashquotes.com
servers:
  - url: https://app.flashquotes.com/api
    description: Production server
security:
  - apiKey: []
paths:
  /event/get-events:
    get:
      summary: List Events (Legacy)
      description: >-
        Legacy endpoint returning the original wrapped event list shape. Capped
        at a 7-day window. Maintained for backwards compatibility. New
        integrations should use GET /events.
      parameters:
        - name: event_starts_after
          in: query
          required: true
          description: ISO 8601 date-time with timezone (e.g., 2024-01-01T00:00:00-05:00)
          schema:
            type: string
            format: date-time
        - name: event_starts_before
          in: query
          required: true
          description: ISO 8601 date-time with timezone (e.g., 2024-01-08T00:00:00-05:00)
          schema:
            type: string
            format: date-time
      responses:
        '200':
          description: Events retrieved successfully
          content:
            application/json:
              schema:
                type: array
                items:
                  type: object
                  properties:
                    event:
                      type: array
                      items:
                        $ref: '#/components/schemas/LegacyEventSummary'
        '400':
          description: Invalid date range (must be 7 days or less) or invalid date format
        '401':
          description: Invalid or missing API key
      deprecated: true
components:
  schemas:
    LegacyEventSummary:
      type: object
      description: Legacy event summary shape returned by GET /event/get-events.
      properties:
        id:
          type: string
        name:
          type: string
        startDate:
          type: string
          format: date-time
        endDate:
          type: string
          format: date-time
        location:
          type: string
        status:
          type: string
  securitySchemes:
    apiKey:
      type: apiKey
      in: header
      name: x-api-key
      description: API key for authentication

````