纳税人基本信息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 替换为控制台签发的密钥。完整字段与响应约定见 统一查询