# Get usage statistics

Retrieve current month's email usage and delivery statistics.

Optionally filter by domain_id to get statistics for a specific sending domain.

Endpoint: GET /api/v1/customer/usage
Version: 1.0.0
Security: ApiKeyAuth

## Query parameters:

  - `domain_id` (integer)
    Filter statistics by specific sending domain ID
    Example: 123

## Response 200 fields (application/json):

  - `current_month` (object)

  - `current_month.emails_sent` (integer)

  - `current_month.emails_delivered` (integer)

  - `current_month.emails_bounced` (integer)

  - `current_month.emails_complained` (integer)

  - `current_month.emails_opened` (integer)

  - `current_month.emails_clicked` (integer)

  - `current_month.delivery_rate` (string)
    Percentage as string (e.g., "99.16")

  - `current_month.bounce_rate` (string)
    Percentage as string

  - `limits` (object)

  - `limits.monthly_limit` (integer)

  - `limits.remaining` (integer)

  - `limits.used_percentage` (string)
    Percentage as string

## Response 401 fields (application/json):

  - `error` (string)
    Error code or message

## Response 500 fields (application/json):

  - `error` (string)
    Error code or message