# Get lockbox events

Retrieve lockbox events with optional filtering and pagination

Endpoint: GET /lockbox_events
Version: 1.1.1
Security: BearerAuth

## Query parameters:

  - `serial_numbers` (array)
    Filter by comma-separated list of serial numbers
    Example: ["1234567"]

  - `lockbox_ids` (array)
    Filter by comma-separated list of lockbox IDs
    Example: ["123e4567-e89b-12d3-a456-426614174000"]

  - `lockbox_event_ids` (array)
    Filter by comma-separated list of lockbox event IDs
    Example: ["123e4567-e89b-12d3-a456-426614174002"]

  - `account_id` (string)
    Filter by account ID
    Example: "4b88ff32-8ba0-4bbf-8e60-c789909ac176"

  - `lockbox_type` (string)
    Filter by lockbox type
    Enum: "Sentrilock"

  - `event_types` (array)
    Filter by event types
    Enum: "Install", "Uninstall", "Generate Code"

  - `created_at_from` (string)
    Filter events created after this timestamp (ISO 8601 format)
    Example: "2023-01-01T00:00:00Z"

  - `created_at_to` (string)
    Filter events created before this timestamp (ISO 8601 format)
    Example: "2023-12-31T23:59:59Z"

  - `unit_ids` (array)
    Filter by comma-separated list of unit IDs
    Example: ["12345"]

  - `limit` (integer)
    Maximum number of items to return per page (default 50, max 100)
    Example: 25

  - `page_number` (integer)
    Page number for pagination (0-indexed, default 0)
    Example: 1

## Response 200 fields (application/json):

  - `id` (string, required)
    Unique identifier

  - `lockbox_id` (string, required)
    ID of the lockbox
    Example: "123e4567-e89b-12d3-a456-426614174000"

  - `event_type` (string, required)
    Type of event
    Enum: "Install", "Uninstall", "Generate Code"

  - `unit_id` (string, required)
    ID of the unit associated with the event
    Example: "12345"

  - `account_id` (string)
    ID of the account associated with the event
    Example: "4b88ff32-8ba0-4bbf-8e60-c789909ac176"

  - `created_at` (string, required)
    Timestamp when the event occurred
    Example: "2023-01-15T12:30:00Z"

  - `metadata` (object)
    Additional metadata about the event
    Example: {"installer_id":"user_12345","notes":"Installed on front door"}

## Response 400 fields (application/json):

  - `error` (string, required)
    Error message
    Example: "Invalid request parameters"

  - `details` (array)
    Detailed error information
    Example: [{"keyword":"required","dataPath":"","schemaPath":"#/required","params":{"missingProperty":"account_id"},"message":"should have required property 'account_id'"}]

## Response 401 fields (application/json):

  - `error` (string, required)
    Error message
    Example: "Invalid request parameters"

  - `details` (array)
    Detailed error information
    Example: [{"keyword":"required","dataPath":"","schemaPath":"#/required","params":{"missingProperty":"account_id"},"message":"should have required property 'account_id'"}]

## Response 500 fields (application/json):

  - `error` (string, required)
    Error message
    Example: "Invalid request parameters"

  - `details` (array)
    Detailed error information
    Example: [{"keyword":"required","dataPath":"","schemaPath":"#/required","params":{"missingProperty":"account_id"},"message":"should have required property 'account_id'"}]