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

# List inspection events

> Inspection events only (e.g. radon drop-off / pick-up).

<Note>
  **The Hive Inspect API is a work in progress.** It is available to a small group of accounts today, and the release for everyone is coming very soon.
</Note>


## OpenAPI

````yaml /api/openapi.json get /v1/events
openapi: 3.1.0
info:
  title: Hive Inspect API
  version: 1.0.0
  description: Connect other tools to your Hive Inspect contacts, inspections and events.
servers:
  - url: https://api.hiveinspect.com
security:
  - bearerAuth: []
tags:
  - name: Contacts
    description: Agents, clients and every other contact in your organization.
  - name: Agencies
    description: The brokerages your agents belong to. Read-only.
  - name: Inspections
    description: Read-only access to your inspections.
  - name: Attachments
    description: Additional reports and additional documents on an inspection.
  - name: Events
    description: Extra appointments on an inspection, such as a radon drop-off or pick-up.
paths:
  /v1/events:
    get:
      tags:
        - Events
      summary: List inspection events
      description: Inspection events only (e.g. radon drop-off / pick-up).
      operationId: listEvents
      parameters:
        - name: inspection_id
          in: query
          required: false
          description: Events on this inspection
          schema:
            type: string
            format: uuid
        - name: inspector_id
          in: query
          required: false
          description: Assigned to this inspector
          schema:
            type: string
            format: uuid
        - name: start_after
          in: query
          required: false
          description: ISO 8601 date or timestamp; starting at/after this time
          schema:
            type: string
        - name: start_before
          in: query
          required: false
          description: ISO 8601 date or timestamp; starting before this time
          schema:
            type: string
        - name: updated_since
          in: query
          required: false
          description: ISO 8601 date or timestamp; created or changed at/after this time
          schema:
            type: string
        - name: include_canceled
          in: query
          required: false
          description: true to include events on canceled inspections
          schema:
            type: boolean
        - name: sort
          in: query
          required: false
          description: start_at or -start_at (default start_at)
          schema:
            type: string
        - name: cursor
          in: query
          required: false
          description: '`next_cursor` from the previous page'
          schema:
            type: string
        - name: limit
          in: query
          required: false
          description: Page size, 1-200 (default 50)
          schema:
            type: integer
            minimum: 1
            maximum: 200
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/EventList'
        '400':
          description: Invalid parameter
        '401':
          description: Missing, invalid or inactive API key
        '429':
          description: Rate limit exceeded (120 requests/minute per key owner)
components:
  schemas:
    EventList:
      type: object
      properties:
        data:
          type: array
          items:
            $ref: '#/components/schemas/Event'
        next_cursor:
          type:
            - string
            - 'null'
        total:
          type: integer
          description: Every record matching the filters, across all pages
      example:
        data:
          - id: e5f6a7b8-5555-4e6f-8a7b-8c9d0e1f2a3b
            name: Radon Drop-off
            description: Place monitor in basement
            event_type: null
            inspection_id: 3f2a9c1e-6b4d-4e7a-8c15-9d0e1f2a3b4c
            start_at: '2026-09-22T16:00:00Z'
            end_at: '2026-09-22T17:00:00Z'
            duration_hours: 1
            blocks_calendar: true
            inspector_id: c3d4e5f6-3333-4c4d-8e5f-6a7b8c9d0e1f
            inspector_ids:
              - c3d4e5f6-3333-4c4d-8e5f-6a7b8c9d0e1f
            created_at: '2026-09-10T18:25:02Z'
            updated_at: '2026-09-10T18:25:02Z'
        next_cursor: null
        total: 1
    Event:
      type: object
      properties:
        id:
          type: string
          format: uuid
        name:
          type:
            - string
            - 'null'
        description:
          type:
            - string
            - 'null'
        event_type:
          type: 'null'
        inspection_id:
          type: string
          format: uuid
        start_at:
          type:
            - string
            - 'null'
          format: date-time
        end_at:
          type:
            - string
            - 'null'
          format: date-time
        duration_hours:
          type: number
        blocks_calendar:
          type: boolean
        inspector_id:
          type:
            - string
            - 'null'
        inspector_ids:
          type: array
          items:
            type: string
        created_at:
          type:
            - string
            - 'null'
          format: date-time
        updated_at:
          type:
            - string
            - 'null'
          format: date-time
      example:
        id: e5f6a7b8-5555-4e6f-8a7b-8c9d0e1f2a3b
        name: Radon Drop-off
        description: Place monitor in basement
        event_type: null
        inspection_id: 3f2a9c1e-6b4d-4e7a-8c15-9d0e1f2a3b4c
        start_at: '2026-09-22T16:00:00Z'
        end_at: '2026-09-22T17:00:00Z'
        duration_hours: 1
        blocks_calendar: true
        inspector_id: c3d4e5f6-3333-4c4d-8e5f-6a7b8c9d0e1f
        inspector_ids:
          - c3d4e5f6-3333-4c4d-8e5f-6a7b8c9d0e1f
        created_at: '2026-09-10T18:25:02Z'
        updated_at: '2026-09-10T18:25:02Z'
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: Your API key from Business Tools → API Access.

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.