# 批量查询获取用户信息 |拥有此API的权限集| |:----- | |用户管理-查询用户信息| **请求方式及url** - 请求方式：`POST` - 请求头：`Content-Type:application/json` - 接口地址：`https://api.xiaoe-tech.com/xe.user.batch_by_user_id.get/1.0.0` - 频率限制：`10秒1000次` - 注：该接口最大获取前10000条数据 {%     api      method="POST",     data={        "access_token": "xxxxxxxx", "user_id_list": [ "u_xxxx", "u_xxxx", "u_xxxx" ], "page": 1, "page_size": 3     },     url="https://api-doc.xiaoe-tech.com/_agent/forward?url=https://api.xiaoe-tech.com/xe.user.batch_by_user_id.get/1.0.0" %}  {% endapi %} **请求参数** |参数名|必选|类型|说明| |:---- |:---|:----- |----- | |access_token |是 |string |[专属token](./../get_access_token.md) | |user_id_list |是 |array |用户user_id数组，最大50 | |page |是|int| 页码，表示第几页，从1开始 | |page_size |是 |int| 每页条数，最大50条 | **请求示例** ``` { "access_token": "xxxxxxxx", "user_id_list": [ "u_xxxx", "u_xxxx", "u_xxxx" ], "page": 1, "page_size": 3 } ``` **返回参数说明** |参数名|类型|说明| |:----- |:-----|----- | |code |int |状态码：0-成功，其他为错误 | |message |string |对返回码的文本描述内容 | |data.list |array |用户列表 | |data.list.user_id |string |用户id | |data.list.wx_union_id |string |微信union_id | |data.list.wx_app_open_id |string | 小程序open_id | |data.list.wx_open_id |string | 微信open_id | |data.list.user_nickname |string |用户昵称 | |data.list.bind_phone |string |绑定手机号 | |data.list.collect_phone |string |采集手机号 | |data.list.avatar |string |头像 | |data.list.from |string |用户来源：0-微信、1-sdk、2-字节跳动、3-百度、4-飞书企业内训、5-小班课app、6-通用h5、7-微博、8-B端导入、9-手机号注册、10-QQ | |data.list.pay_sum |float |消费总额（元） | |data.list.punch_count |int | 购买次数 | |data.list.user_created_at |string | 用户创建时间 | |data.total|float | 查询结果记录数 | **返回示例** ``` { "code": 0, "msg": "ok", "data": { "list": [ { "user_id": "u_qq_xxxx", "wx_union_id": "", "wx_app_open_id": "", "wx_open_id": "", "user_nickname": "xxx", "bind_phone": "", "collect_phone": "", "avatar": "xxxxx", "from": "QQ", "pay_sum": 0, "punch_count": 0, "user_created_at": "2021-08-03 11:37:48" }, ... ], "total": 2 } } ``` **备注** - 更多返回错误代码请看首页的错误代码描述