# Get lockboxes

Retrieve lockboxes with optional filtering and pagination

Endpoint: GET /lockboxes
Version: 1.1.1
Security: BearerAuth

## Query parameters:

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

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

  - `account_id` (string)
    Filter by lockboxes associated with a specific RentEngine account by the account's id
    Example: "4b88ff32-8ba0-4bbf-8e60-c789909ac176"

  - `lockbox_type` (string)
    Filter by lockbox type (currently only SentriLock is supported via API. Codebox is supported via the UI only)
    Enum: "Sentrilock"

  - `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_type` (string, required)
    Type of lockbox
    Enum: "Sentrilock"

  - `serial_number` (string, required)
    Serial number of the lockbox
    Example: "1234567"

  - `account_id` (string, required)
    ID of the account that owns the lockbox
    Example: "4b88ff32-8ba0-4bbf-8e60-c789909ac176"

  - `created_at` (string, required)
    Timestamp when the lockbox was created
    Example: "2023-01-15T12:00:00Z"

  - `updated_at` (string, required)
    Timestamp when the lockbox was last updated
    Example: "2023-01-16T14:30:00Z"

## 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'"}]