# List all bills for the entity

Returns a paginated list of bills with optional status filtering.

Endpoint: GET /bills
Version: 1.0.0
Security: apiKeyAuth

## Query parameters:

  - `statuses` (any)

  - `limit` (integer)

  - `offset` (any)
    Opaque offset identifier for pagination. Use the nextOffset from a previous response.

## Header parameters:

  - `x-entity-id` (string)
    Optional entity ID for scoped access to entity-specific data

## Response 200 fields (application/json):

  - `bills` (array, required)
    List of bills

  - `bills.id` (string, required)
    The unique identifier for the bill

  - `bills.status` (string, required)
    The current status of the bill
    Enum: "CANCELED", "DRAFT_PROCESSING", "DRAFT", "PAYMENT_INFO_NEEDED", "PENDING", "APPROVED", "REJECTED", "SCHEDULED", "PAYMENT_INITIATED", "PAYMENT_DELIVERED", "PAYMENT_FAILED", "PAYMENT_CANCELED"

  - `bills.vendor_name` (string, required)
    The name of the vendor

  - `bills.invoice_number` (any)
    The invoice number

  - `bills.description` (any)
    Description of the bill

  - `bills.memo` (any)
    Memo for the bill

  - `bills.bill_date` (any)
    The bill date

  - `bills.bill_due_date` (any)
    The due date

  - `bills.bill_total` (any)
    The total amount of the bill

  - `bills.currency` (any)
    The currency code (ISO 4217)

  - `bills.payment_type` (any)
    The payment type

  - `bills.contact_id` (any)
    The ID of the associated contact

  - `bills.created_at` (string, required)
    The creation timestamp

  - `bills.paid_at` (any)
    The paid timestamp

  - `bills.scheduled_at` (any)
    The scheduled payment timestamp

  - `page` (any)
    Pagination metadata

## Response 422 fields (application/json):

  - `detail` (array)

  - `detail.loc` (array, required)

  - `detail.msg` (string, required)

  - `detail.type` (string, required)