> ## Documentation Index
> Fetch the complete documentation index at: https://docs.nevatal.com/llms.txt
> Use this file to discover all available pages before exploring further.

# List Invoices

> Retrieve a paginated list of invoices

## Query Parameters

<ParamField query="page" type="integer" default="1">Page number</ParamField>
<ParamField query="limit" type="integer" default="20">Results per page</ParamField>
<ParamField query="patientId" type="string">Filter by patient</ParamField>
<ParamField query="status" type="string">Filter by status: `draft`, `approved`, `paid`, `overdue`, `voided`</ParamField>
<ParamField query="from" type="string">Invoice date from (`YYYY-MM-DD`)</ParamField>
<ParamField query="to" type="string">Invoice date to (`YYYY-MM-DD`)</ParamField>

<RequestExample>
  ```bash cURL theme={null}
  curl -X GET "https://api.nevatal.com/api/v1/billing/invoices?status=approved" \
    -H "Authorization: Bearer nvtl_your_api_key"
  ```
</RequestExample>

<ResponseExample>
  ```json 200 theme={null}
  {
    "data": [
      {
        "id": "inv_001",
        "invoiceNumber": "FV-2025-0042",
        "patientId": "pat_abc123",
        "patient": {
          "firstName": "María",
          "lastName": "García"
        },
        "status": "approved",
        "subtotal": 150000,
        "tax": 28500,
        "total": 178500,
        "currency": "COP",
        "items": [
          {
            "description": "Consulta General",
            "quantity": 1,
            "unitPrice": 150000,
            "total": 150000
          }
        ],
        "createdAt": "2025-03-15T10:30:00Z",
        "approvedAt": "2025-03-15T11:00:00Z"
      }
    ],
    "pagination": {
      "page": 1,
      "limit": 20,
      "total": 320
    }
  }
  ```
</ResponseExample>