列出开票发票

列出缩放帐户的 [发票](https://support.zoom.us/hc/en-us/articles/207276556-查看您的发票历史记录 # h_6710542f-23cc-4059-9cc7-ff02bec7314e)。

要列出常规缩放帐户的发票或主帐户的发票，请提供 “我” 作为 “帐户” 路径参数的值。要列出子帐户的发票，请在 “accountid” 路径参数中提供子帐户的帐户ID。

** 先决条件: **

帐户必须在Pro或更高的计划中注册。

** 额外速率限制: ** 您可以每 ** 五分钟向每个账户 ('accountId') 发出 ** 一个 ** API请求，直到达到每日限制。此API的每个帐户 ('accountId') 的每日限制为 ** 6 ** 个请求。

** 范围: ** 'billing:master'

** [速率限制标签](https://marketplace.zoom.us/docs/api参考/速率限制 # 速率限制):** “沉重”

请求参数

Path 参数

accountId

string

帐户的唯一标识符。

必需

Query 参数

from

string

可选

'Yyyy-mm-dd-' 格式的发票查询的开始日期。“从” 和 “到” 参数定义的日期范围不应超过一年。定义的范围应在过去三年内。

string

可选

'Yyyy-mm-dd-' 格式的发票查询结束日期

返回响应

🟢200** HTTP状态代码: ** '200' 返回帐户帐单发票信息。

application/json

Body

invoices

array [object {9}]

可选

tax_amount

number <double>

税额。

可选

示例值:

35.9

balance

number <double>

可选

应用所有付款、调整和退款后发票的剩余余额。

示例值:

12.34

target_date

string

可选

此日期用于确定要计费的费用。在此日期或之前开具账单的所有费用都将包含在发票中。

示例值:

2022-03-01

total_amount

number <double>

发票总额。

可选

示例值:

1000.21

due_date

string

可选

此发票的付款到期日期。

示例值:

2022-02-08

string

发票的唯一标识符。

可选

示例值:

Inv2329df

invoice_number

string

发票编号。

可选

示例值:

23jkfk21000

invoice_date

string

生成发票的日期。

可选

示例值:

2022-01-18

status

string

发票的状态。

可选

默认值:

"Draft"

示例值:

Draft

currency

string

发票中使用的币种。

可选

示例值:

USD

示例

{
    "invoices": [
        {
            "tax_amount": 35.9,
            "balance": 12.34,
            "target_date": "2022-03-01",
            "total_amount": 1000.21,
            "due_date": "2022-02-08",
            "id": "Inv2329df",
            "invoice_number": "23jkfk21000",
            "invoice_date": "2022-01-18",
            "status": "\"Draft\""
        }
    ],
    "currency": "USD"
}

🟠400** HTTP状态代码: ** '400' <br> 错误的请求 ** 错误代码: ** '200' <br> 仅适用于已支付帐户: {subAccountId}。 ** 错误代码: ** '2001' <br> 帐户不存在: {subAccountId}。

请求参数

示例代码

返回响应