> 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"},"msg":{"type":"string"}}}}},"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":"成功响应","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"$ref":"#/components/schemas/ErrorCodeMsg/properties/code","description":"The status of this request, where 0 indicates success and other values indicate errors."},"msg":{"$ref":"#/components/schemas/ErrorCodeMsg/properties/msg","description":"\"Success\" or error message."},"data":{"type":"object","properties":{"screeningCount":{"type":"integer","format":"int64","description":"符合查询条件的 screen 任务数量。"}}}}}}}}},"summary":"查询筛查用量"}}}}
```