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

# Listar facturas

> Lista las facturas de tu empresa, emitidas e importadas.

Es [el mismo listado de siempre](/client/invoices/list). Las facturas emitidas por OnePay traen además el bloque fiscal (`fiscal_status`, `items`, `stampings`, `totals`); las importadas de tu sistema de gestión salen exactamente como antes.

Para ver solo las emitidas ante la DIAN, filtra por `fiscal_status`.

### Query

<ParamField query="fiscal_status" type="string" placeholder="accepted">
  Filtra por estado ante la DIAN: `queued`, `accepted`, `rejected`, `contingency`.
</ParamField>

<ParamField query="reference" type="string" placeholder="1020304050">
  Filtra por la referencia con la que creaste la factura.
</ParamField>

<ParamField query="per_page" type="integer" placeholder="25">
  Resultados por página. Máximo 100, por defecto 25.
</ParamField>

<RequestExample>
  ```bash cURL theme={null}
  curl "https://api.onepay.la/v1/invoices?fiscal_status=accepted&per_page=50" \
    -H "Authorization: Bearer $ONEPAY_API_KEY"
  ```
</RequestExample>

<ResponseExample>
  ```json 200 theme={null}
  {
    "data": [
      {
        "id": "inv_01J8XK9V4N",
        "status": "PAID",
        "fiscal_status": "accepted",
        "stamp_policy": "on_payment",
        "currency": "COP",
        "customer": { "id": "cus_01J8XK2P9WQZ", "name": "Ana Ramírez" },
        "totals": { "subtotal": 23990000, "tax_amount": 4558100, "total": 28548100 },
        "stampings": [
          { "type": "invoice", "status": "accepted", "number": "FE1", "cufe": "a3f5c8e2..." }
        ]
      }
    ],
    "links": { "next": null },
    "meta": { "current_page": 1, "total": 1 }
  }
  ```
</ResponseExample>