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

# 列出发票

> 列出团队的发票，按时间倒序，可按状态筛选

```
GET /openapi/memorylake/admin/v1/billing/invoices
```

列出团队的发票，按时间倒序，可按状态筛选。

<Note>
  **所需权限：** `invoice:read`
</Note>

### 查询参数

<ParamField query="status" type="array">
  可重复。仅返回处于这些状态的发票
</ParamField>

<ParamField query="page_size" type="integer" default="20">
  每页条数（1–100）
</ParamField>

<ParamField query="continuation_token" type="string">
  上一页返回的令牌
</ParamField>

<RequestExample>
  ```bash cURL theme={null}
  curl -X GET 'https://app.memorylake.cn/openapi/memorylake/admin/v1/billing/invoices' \
    -H 'Authorization: Bearer sk_xxxxxx'
  ```
</RequestExample>

### 响应

<ResponseField name="data" type="object">
  <Expandable title="Load More Response Billing Invoice 对象">
    <ResponseField name="items" type="array">
      当前页的条目列表

      <Expandable title="Billing Invoice 对象">
        <ResponseField name="created_at" type="integer">签发时间，Unix 秒级时间戳</ResponseField>
        <ResponseField name="hosted_invoice_url" type="string">支付服务商托管的发票页面；没有时为 null</ResponseField>
        <ResponseField name="invoice_id" type="string">发票 ID</ResponseField>
        <ResponseField name="invoice_pdf_url" type="string">支付服务商自身的 PDF 链接；服务商尚未提供时为 null。GET /billing/invoices/\{invoice\_id}/pdf 始终在本 API 内直接返回 PDF</ResponseField>
        <ResponseField name="number" type="string">票面上印制的发票号码</ResponseField>
        <ResponseField name="order_id" type="string">其所属的订单（GET /billing/orders/\{order\_id}）；没有时为 null</ResponseField>
        <ResponseField name="status" type="string">发票状态。可选值：`draft`、`open`、`paid`、`uncollectible`、`void`。</ResponseField>

        <ResponseField name="subtotal" type="object">
          税前合计

          <Expandable title="Money 对象">
            <ResponseField name="amount" type="integer">以该币种最小单位计的金额（`usd` 为美分）</ResponseField>
            <ResponseField name="currency" type="string">小写的 ISO 4217 货币代码</ResponseField>
          </Expandable>
        </ResponseField>

        <ResponseField name="tax" type="object">
          税额

          <Expandable title="Money 对象">
            <ResponseField name="amount" type="integer">以该币种最小单位计的金额（`usd` 为美分）</ResponseField>
            <ResponseField name="currency" type="string">小写的 ISO 4217 货币代码</ResponseField>
          </Expandable>
        </ResponseField>

        <ResponseField name="total" type="object">
          合计

          <Expandable title="Money 对象">
            <ResponseField name="amount" type="integer">以该币种最小单位计的金额（`usd` 为美分）</ResponseField>
            <ResponseField name="currency" type="string">小写的 ISO 4217 货币代码</ResponseField>
          </Expandable>
        </ResponseField>

        <ResponseField name="due_at" type="integer">付款截止时间，Unix 秒级时间戳</ResponseField>
      </Expandable>
    </ResponseField>

    <ResponseField name="continuation_token" type="string">用于获取下一页的令牌；最后一页不返回</ResponseField>
    <ResponseField name="total" type="integer">所有分页中符合筛选条件的条目总数；无法获取计数时省略</ResponseField>
  </Expandable>
</ResponseField>

<ResponseExample>
  ```json Success (200) theme={null}
  {
    "success": true,
    "message": "Operation completed successfully",
    "data": {
      "items": [
        {
          "created_at": 1760000000,
          "hosted_invoice_url": "https://example.com/hosted_invoice",
          "invoice_id": "fc9ec77f14773109fc1b0f8a2749731e",
          "invoice_pdf_url": "https://example.com/invoice_pdf",
          "number": "example",
          "order_id": "98fae70aa1ad919811f9214706e755e1",
          "status": "draft",
          "subtotal": {
            "amount": 1999,
            "currency": "usd"
          },
          "tax": {
            "amount": 1999,
            "currency": "usd"
          },
          "total": {
            "amount": 1999,
            "currency": "usd"
          },
          "due_at": 1760000000
        }
      ],
      "continuation_token": "eyJvZmZzZXQiOjIwfQ",
      "total": 1
    }
  }
  ```
</ResponseExample>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.