# Get a specific bill

Returns details for a specific bill by ID, including all line items.

Endpoint: GET /bills/{bill_id}
Version: 1.0.0
Security: apiKeyAuth

## Path parameters:

  - `bill_id` (string, required)
    The bill ID

## Header parameters:

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

## Response 200 fields (application/json):

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

  - `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"

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

  - `invoice_number` (any)
    The invoice number

  - `description` (any)
    Description of the bill

  - `memo` (any)
    Memo for the bill

  - `bill_date` (any)
    The bill date

  - `bill_due_date` (any)
    The due date

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

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

  - `payment_type` (any)
    The payment type

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

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

  - `paid_at` (any)
    The paid timestamp

  - `scheduled_at` (any)
    The scheduled payment timestamp

  - `line_items` (array)
    Line items for the bill

  - `line_items.id` (string, required)
    The unique identifier for the line item

  - `line_items.amount` (string, required)
    The amount for the line item

  - `line_items.quantity` (any)
    The quantity (for ITEM type)

  - `line_items.description` (string, required)
    Description of the line item

  - `line_items.type` (string, required)
    Type of line item (EXPENSE or ITEM)
    Enum: "EXPENSE", "ITEM"

  - `line_items.amount_total` (string, required)
    The total amount (amount * quantity for ITEM)

## Response 422 fields (application/json):

  - `detail` (array)

  - `detail.loc` (array, required)

  - `detail.msg` (string, required)

  - `detail.type` (string, required)