`list_enterprise_branches`

列出企业的分支机构（ads_enterprise_branch，工商「分支机构」）。需 ent_id（先 search_enterprise 获取）；可按分支机构名称 keyword 过滤。与 get_enterprise_profile 的统计不同，本接口返回分支机构明细列表。

英文描述

List branch offices of an enterprise from ads_enterprise_branch. Use for 分支机构. Requires ent_id from search_enterprise or get_enterprise_by_ent_id.

文档更新：2026-06-23T10:00:00+08:00

请求参数

参数名	参数说明	数据类型	样例数据
`ent_id`	必填；至少 1 个字符	string	EN202401011234567890
`keyword`	选填；至少 1 个字符	string	（选填，示例中省略）
`limit`	选填	integer	20
`offset`	选填	integer	0

响应参数

参数名	参数说明	数据类型	样例数据
`data`	业务记录数组	array	[{"ent_id": "EN202401011234567890", "branch_name": "上海某某化工有限公司杭州分公司", "branch_credit_code": "91330100MA2XXXXXX", "reg_status": "存续", "legal_person": "李四"}]
`data[].ent_id`	所属企业 ent_id	string	EN202401011234567890
`data[].branch_name`	分支机构名称	string	上海某某化工有限公司杭州分公司
`data[].branch_credit_code`	分支机构信用代码	string	91330100MA2XXXXXX
`data[].reg_status`	登记状态	string	存续
`data[].legal_person`	负责人	string	李四
`meta.total`	命中总数	integer	100
`meta.limit`	本页 limit	integer	20
`meta.offset`	本页 offset	integer	0
`meta.has_more`	是否还有下一页	boolean	true

响应状态说明

状态	说明
`success`	调用成功，返回业务数据
`failed`	参数错误、后端业务错误或系统异常
`denied`	API Key 无效、无权限、RBAC/菜单拒绝等

请求示例

{
  "ent_id": "EN202401011234567890",
  "limit": 20,
  "offset": 0
}

响应示例

{
  "data": [
    {
      "ent_id": "EN202401011234567890",
      "branch_name": "上海某某化工有限公司杭州分公司",
      "branch_credit_code": "91330100MA2XXXXXX",
      "reg_status": "存续",
      "legal_person": "李四"
    }
  ],
  "meta": {
    "total": 1,
    "limit": 20,
    "offset": 0,
    "has_more": false
  }
}