纳税人基本信息API接口查询
查询企业纳税人基本信息(纳税人资质、一般纳税人认定日期、纳税人状态等)。filters.id 必填(也可用顶层 query):企业ID。本接口无分页,不支持 filters.offset。
已开放
调用入口:POST /v1/data/query。
请求体字段
| 字段 | 类型 | 说明 | 示例 |
|---|---|---|---|
| domain | string | 数据域(必填) | enterprise |
| type | string | 数据类型(必填) | taxpayer_basic |
| query | string | 自然语言检索词 | 5bb6be9aa9ae9a74da456375 |
| filters | object | 结构化过滤条件,见下方「常用 filters」 | — |
常用 filters
| 字段 | 类型 | 说明 | 示例 |
|---|---|---|---|
| id | string | 企业标识(必填;企业ID;也可用 query) | 5bb6be9aa9ae9a74da456375 |
返回字段(hits[])
| 字段 | 类型 | 说明 |
|---|---|---|
| taxpayerQualification | string | 纳税人资质 |
| taxpayerJudgeDate | string | 一般纳税人认定日期 |
| abnormalEnterprisesState | string | 纳税人状态 |
| abnormalEnterprisesJudgeDate | string | 非正常户认定日期 |
curl 请求示例
curl -sS -X POST https://data.devnors.com/v1/data/query \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{ "domain":"enterprise", "type":"taxpayer_basic", "query":"5bb6be9aa9ae9a74da456375", "filters":{ "id":"5bb6be9aa9ae9a74da456375" } }'将 YOUR_API_KEY 替换为控制台签发的密钥。完整字段与响应约定见 统一查询。