1. 接口描述
接口请求域名: ocr.tencentcloudapi.com 。
提供查询企业基本信息的能力。输入企业名称或统一社会信用代码,返回企业名称、统一社会信用代码、法定代表人、登记机关、经营期限、经营状态、经营范围、注册地址、主体类型、成立日期、核准日期、行政区划等企业登记信息。部分出参可能为空或无法查得,具体以实际查询结果为准。
重要提醒:使用本产品需要符合真实企业、真实业务场景、真实用户授权的要求,请联系商务或在线客服登记信息、开通服务。
2. 输入参数
以下请求参数列表仅列出了接口请求参数和部分公共参数,完整公共参数列表见 公共请求参数。
| 参数名称 | 必选 | 类型 | 描述 |
|---|---|---|---|
| Action | 是 | String | 公共参数,本接口取值:QueryEnterpriseBasicInfo。 |
| Version | 是 | String | 公共参数,本接口取值:2018-11-19。 |
| Region | 否 | String | 公共参数,此参数为可选参数。 |
| CreditCode | 否 | String | 统一社会信用代码。CreditCode、EntName 必须提供一个,如果都提供,只使用 CreditCode。 示例值:91440300708461136T |
| EntName | 否 | String | 企业名称。CreditCode、EntName 必须提供一个,如果都提供,只使用 CreditCode。 示例值:深圳市腾讯计算机系统有限公司 |
3. 输出参数
| 参数名称 | 类型 | 描述 |
|---|---|---|
| StatusCode | Integer | 请求状态。 示例值:0 |
| CreditCode | String | 统一社会信用代码。 示例值:91440300708461136T |
| EntName | String | 企业名称。 示例值:深圳市腾讯计算机系统有限公司 |
| Type | String | 主体类型。 示例值:有限责任公司 |
| LrName | String | 法人代表。 示例值:张三 |
| Capital | String | 注册资本。 示例值:6500万人民币 |
| Address | String | 企业登记住所或注册地址。 示例值:深圳市南山区粤海街道麻岭社区科技中一路腾讯大厦35层 |
| Business | String | 经营范围。 示例值:计算机软、硬件的设计、技术开发、销售(不含专营、专控、专卖商品及限制项目);数据库及计算机网络服务;国内商业、物资供销业(不含专营、专控、专卖商品) |
| RegistrationAuthority | String | 登记机关。 示例值:深圳市市场监督管理局 |
| OperatingStatus | String | 经营状态(标准化),枚举值: 示例值:1 |
| RawOperatingStatus | String | 经营状态(原始值)。 示例值:吊销,已注销 |
| SetDate | String | 成立日期。 示例值:1998-11-11 |
| OperatingPeriod | String | 营业期限:一般包括营业开始时间和结束时间 示例值:1998-11-11/ |
| ApprovalDate | String | 核准日期。 示例值:2024-01-04 |
| Province | String | 所在省份。 示例值:广东省 |
| ProvinceCode | String | 所在省份的行政区划代码。 示例值:440000 |
| City | String | 所在城市。 示例值:深圳市 |
| CityCode | String | 所在城市的行政区划代码。 示例值:440300 |
| District | String | 所在区县。 示例值:南山区 |
| DistrictCode | String | 所在区县的行政区划代码。 示例值:440305 |
| CapitalCurrency | String | 注册资本币种。 示例值:人民币 |
| OrganizationCode | String | 组织机构代码。 示例值:70846113-6 |
| EnglishName | String | 企业英文名称。 示例值:Shenzhen Tencent Computer System Co., Ltd. |
| FormerNames | Array of String | 企业曾用名列表。 示例值:["天天信息技术有限公司", "天天软件有限公司"] |
| OriginalRegNum | String | 原注册号。 示例值:440301103448669 |
| PaidInCapital | String | 实收资本。 示例值:6500万人民币 |
| RevokeDate | String | 吊销日期。 示例值:2024-07-01 |
| RevokeReason | String | 吊销原因。 示例值:公司(含公司类外商投资企业)成立后无正当理由超出法定时限不开业或连续停业超出法定时限的行为 |
| CancellationDate | String | 注销日期。 示例值:2025-03-26 |
| CancellationReason | String | 注销原因。 示例值:经营期限届满 |
| RequestId | String | 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。 |
4. 示例
示例1 企业基本信息查询
输入示例
POST / HTTP/1.1
Host: ocr.tencentcloudapi.com
Content-Type: application/json
X-TC-Action: QueryEnterpriseBasicInfo
<公共请求参数>
{
"CreditCode": "91440300708461136T"
}
输出示例
{
"Response": {
"Address": "深圳市南山区粤海街道麻岭社区科技中一路腾讯大厦35层",
"ApprovalDate": "2024-01-04",
"Business": "一般经营项目:计算机软、硬件的设计、技术开发、销售(不含专营、专控、专卖商品及限制项目);数据库及计算机网络服务;国内商业、物资供销业(不含专营、专控、专卖商品);从事广告业务(法律、行政法规规定应进行广告经营审批等级的,另行办理审批登记后方可经营);货物及技术进出口;票务代理。许可经营项目:第一类增值电信业务中的国内互联网虚拟专用网业务;第二类增值电信业务中的国内多方通信服务业务,国内呼叫中心业务,信息服务业务;网络游戏出版运营;互联网新闻信息转载服务;预包装食品销售(不含冷藏冷冻食品);利用信息网络经营音乐娱乐产品、游戏产品(含网络游戏虚拟货币发行)、艺术品、演出剧(节)目、动漫产品、表演,从事网络文化产品的展览、比赛活动;互联网视听节目服务;制作、复制、发行电视剧、动画片(制作须另申报),专题、专栏(不含时政新闻类),综艺;出版物零售。",
"CancellationDate": "",
"CancellationReason": "",
"Capital": "6500万人民币",
"CapitalCurrency": "人民币",
"City": "深圳市",
"CityCode": "440300",
"CreditCode": "91440300708461136T",
"District": "南山区",
"DistrictCode": "440305",
"EnglishName": "Shenzhen Tencent Computer System Co., Ltd.",
"EntName": "深圳市腾讯计算机系统有限公司",
"FormerNames": [],
"LrName": "马化腾",
"OperatingPeriod": "1998-11-11/",
"OperatingStatus": "1",
"OrganizationCode": "70846113-6",
"OriginalRegNum": "440301103448669",
"PaidInCapital": "6500万人民币",
"Province": "广东省",
"ProvinceCode": "440000",
"RawOperatingStatus": "存续",
"RegistrationAuthority": "深圳市市场监督管理局",
"RevokeDate": "",
"RevokeReason": "",
"SetDate": "1998-11-11",
"StatusCode": 0,
"Type": "有限责任公司",
"RequestId": "f4dc3886-2bdd-46ff-9801-cae8922010f0"
}
}
5. 开发者资源
腾讯云 API 平台
腾讯云 API 平台 是综合 API 文档、错误码、API Explorer 及 SDK 等资源的统一查询平台,方便您从同一入口查询及使用腾讯云提供的所有 API 服务。
API Inspector
用户可通过 API Inspector 查看控制台每一步操作关联的 API 调用情况,并自动生成各语言版本的 API 代码,也可前往 API Explorer 进行在线调试。
SDK
云 API 3.0 提供了配套的开发工具集(SDK),支持多种编程语言,能更方便的调用 API。
- Tencent Cloud SDK 3.0 for Python: CNB, GitHub, Gitee
- Tencent Cloud SDK 3.0 for Java: CNB, GitHub, Gitee
- Tencent Cloud SDK 3.0 for PHP: CNB, GitHub, Gitee
- Tencent Cloud SDK 3.0 for Go: CNB, GitHub, Gitee
- Tencent Cloud SDK 3.0 for Node.js: CNB, GitHub, Gitee
- Tencent Cloud SDK 3.0 for .NET: CNB, GitHub, Gitee
- Tencent Cloud SDK 3.0 for C++: CNB, GitHub, Gitee
- Tencent Cloud SDK 3.0 for Ruby: CNB, GitHub, Gitee
命令行工具
6. 错误码
以下仅列出了接口业务逻辑相关的错误码,其他错误码详见 公共错误码。
| 错误码 | 描述 |
|---|---|
| FailedOperation.UnKnowError | 未知错误。 |
| FailedOperation.UnOpenError | 服务未开通。 |
| InvalidParameterValue.InvalidParameterValueLimit | 参数值错误。 |
| RequestLimitExceeded | 请求的次数超过了频率限制。 |
| ResourceUnavailable.InArrears | 账号已欠费。 |
| ResourceUnavailable.ResourcePackageRunOut | 账号资源包耗尽。 |
| ResourcesSoldOut.ChargeStatusException | 计费状态异常。 |