> For the complete documentation index, see [llms.txt](https://docs.compliance.phalcon.blocksec.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.compliance.phalcon.blocksec.com/zh/api-documentation/account-management/get-screening-usage.md).

# 获取筛查用量

## 查询筛查用量

> 按 screen 任务统计账户的筛查（screening）用量。可按时间区间和目标类型过滤。如果 startTime 和 endTime 均不传，默认返回当前计费周期（billing cycle）内的用量。

```json
{"openapi":"3.0.0","info":{"title":"Compliance API","version":"2.0.0"},"tags":[{"name":"账户","description":"账户级 API，如用量查询。"}],"servers":[{"url":"https://api.blocksec.com/phalcon/compliance/v2","description":"生产环境服务器"}],"security":[{"API-Key":[]}],"components":{"securitySchemes":{"API-Key":{"type":"apiKey","in":"header","name":"API-Key"}},"schemas":{"ErrorCodeMsg":{"properties":{"code":{"type":"integer","description":"业务状态码。`0` 表示请求成功，其它值表示失败。业务错误以 HTTP 200 加非 0 `code` 的形式返回，因此收到 200 并不代表成功，必须检查该字段；鉴权失败与限流则返回非 200 的 HTTP 状态码。两者都需要判断。全部错误码及对应信息见 [https://docs.compliance.phalcon.blocksec.com/api-documentation/introduction/error-messages](https://docs.compliance.phalcon.blocksec.com/api-documentation/introduction/error-messages)。"},"msg":{"type":"string","description":"`code` 为 0 时返回 `\"Success\"`，否则返回该错误码对应的错误信息。"}}}}},"paths":{"/account/usage/screening":{"get":{"tags":["账户"],"description":"按 screen 任务统计账户的筛查（screening）用量。可按时间区间和目标类型过滤。如果 startTime 和 endTime 均不传，默认返回当前计费周期（billing cycle）内的用量。","parameters":[{"name":"startTime","in":"query","required":false,"description":"时间区间的起点（含），Unix 秒时间戳。如果 startTime 和 endTime 均不传，则使用当前计费周期。","schema":{"type":"integer","format":"int64"}},{"name":"endTime","in":"query","required":false,"description":"时间区间的终点（含），Unix 秒时间戳。如果 startTime 和 endTime 均不传，则使用当前计费周期。","schema":{"type":"integer","format":"int64"}},{"name":"target","in":"query","required":false,"description":"要统计的目标类型。不传则统计所有类型。","schema":{"type":"string","enum":["address","transaction"]}}],"responses":{"200":{"description":"响应。即使 HTTP 状态码为 200，`code` 非 0 也表示业务错误。","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"$ref":"#/components/schemas/ErrorCodeMsg/properties/code","description":"业务状态码。`0` 表示请求成功，其它值表示失败。业务错误以 HTTP 200 加非 0 `code` 的形式返回，因此收到 200 并不代表成功，必须检查该字段；鉴权失败与限流则返回非 200 的 HTTP 状态码。两者都需要判断。"},"msg":{"$ref":"#/components/schemas/ErrorCodeMsg/properties/msg","description":"`code` 为 0 时返回 `\"Success\"`，否则返回该错误码对应的错误信息。"},"data":{"type":"object","properties":{"screeningCount":{"type":"integer","format":"int64","description":"符合查询条件的 screen 任务数量。"}}}}}}}},"401":{"description":"鉴权失败。`API-Key` 请求头缺失或无效。"},"429":{"description":"超出调用频率限制。请降低请求频率后重试。"}},"summary":"查询筛查用量"}}}}
```
