# List invoices

Returns a list of all invoices for your organization (read-only).

Endpoint: GET /invoices
Version: 1.0.0
Security: ApiKeyAuth, OrgIdAuth

## Response 200 fields (application/json):

  - `invoices` (array)

  - `invoices.id` (string, required)
    Unique identifier for the invoice

  - `invoices.orgId` (string, required)
    Organization ID

  - `invoices.amount` (string, required)
    Total invoice amount
    Example: "19.99"

  - `invoices.currency` (string, required)
    Currency code
    Example: "usd"

  - `invoices.status` (string, required)
    Invoice status
    Enum: "pending", "paid", "failed", "cancelled"

  - `invoices.stripeInvoiceId` (string,null)
    Stripe invoice ID
    Example: "inv_..."

  - `invoices.stripeInvoiceUrl` (string,null)
    Stripe invoice URL
    Example: "https://invoice.stripe.com/..."

  - `invoices.periodStart` (string, required)
    Billing period start

  - `invoices.periodEnd` (string, required)
    Billing period end

  - `invoices.paidAt` (string,null)
    Payment timestamp

  - `invoices.createdAt` (string)

  - `invoices.updatedAt` (string)

## Response 400 fields (application/json):

  - `error` (string)
    Error message
    Example: "Missing required headers"

  - `details` (string)
    Additional error details
    Example: "x-api-key and x-org-id headers are required"

## Response 401 fields (application/json):

  - `error` (string)
    Error message
    Example: "Missing required headers"

  - `details` (string)
    Additional error details
    Example: "x-api-key and x-org-id headers are required"