> For the complete documentation index, see [llms.txt](https://doc.xspark.cn/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://doc.xspark.cn/api/ip-management/list-of-purchased-ips.md).

# 获取已购IP列表

## POST /api/open/static/list

> 查询已购静态 ISP 代理或数据中心代理信息列表。

```json
{"openapi":"3.0.3","info":{"title":"xspark-api","version":"1.0.0"},"servers":[{"url":"https://api.xspark.cn"}],"security":[{"ApiKey":[]}],"components":{"securitySchemes":{"ApiKey":{"type":"apiKey","in":"header","name":"ApiKey","description":"在请求头 ApiKey 中填写你的 API KEY。  \n格式：ApiKey: YOUR_API_KEY。  \n请将 YOUR_API_KEY 替换为你的 API KEY 值"}}},"paths":{"/api/open/static/list":{"post":{"description":"查询已购静态 ISP 代理或数据中心代理信息列表。","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"ip_type":{"type":"integer","description":"1 静态 ISP；2 数据中心。默认 1。","enum":[1,2],"default":1},"ip":{"type":"string","description":"网络地址；单个值模糊匹配，多个地址用英文逗号分隔并精确匹配。"},"username":{"type":"string","description":"按连接用户名模糊筛选。"},"password":{"type":"string","description":"按连接密码模糊筛选。"},"status":{"type":"integer","description":"1 未到期；2 已过期。","enum":[1,2]},"region_id":{"type":"integer","description":"静态地区 ID。"},"remaining_days":{"type":"integer","description":"筛选未来指定天数内到期的节点。","maximum":3650},"start_time":{"type":"string","description":"到期开始时间，支持 YYYY-MM-DD、YYYY-MM-DD HH:mm:ss 或 RFC3339；无时区格式按 UTC+08:00。"},"end_time":{"type":"string","description":"到期结束时间，格式同 start_time；仅传日期时包含该日期的最后一秒。"},"start_time_order":{"type":"integer","description":"开通时间排序：1 升序，2 降序。","enum":[1,2]},"expire_time_order":{"type":"integer","description":"到期时间排序：1 升序，2 降序。同时传开通时间与到期时间排序时，到期时间排序优先生效","enum":[1,2]},"page":{"type":"integer","description":"页码，默认 1。","default":1},"size":{"type":"integer","description":"每页条数，默认 20，最大 100。","default":20,"maximum":100}}}}},"description":"请求参数"},"responses":{"200":{"description":"返回示例","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"integer","description":"请求处理状态码，200 表示成功。"},"data":{"type":"object","properties":{"list":{"type":"array","items":{"type":"object","properties":{"record_id":{"type":"integer","description":"静态网络节点记录 ID。"},"ip":{"type":"string","description":"网络地址。"},"port":{"type":"integer","description":"连接端口。"},"username":{"type":"string","description":"连接用户名。"},"password":{"type":"string","description":"连接密码。"},"region_id":{"type":"integer","description":"地区 ID。"},"region_name":{"type":"string","description":"地区名称。"},"start_time":{"type":"integer","format":"int64","description":"开通时间，Unix 秒。"},"expire_time":{"type":"integer","format":"int64","description":"到期时间，Unix 秒。"},"status":{"type":"integer","description":"1 正常；2 已过期。"},"status_text":{"type":"string","description":"状态文字。"},"remark":{"type":"string","description":"用户备注。"},"is_released":{"type":"boolean","description":"节点是否已回收。"},"can_renew":{"type":"boolean","description":"当前是否可续费。"},"can_change":{"type":"boolean","description":"当前是否可更换。"},"renew_unavailable_reason":{"type":"string","description":"不可续费时的原因。"},"change_deadline":{"type":"integer","format":"int64","description":"更换截止时间，Unix 秒。"}}},"description":"节点记录数组。"},"total":{"type":"integer","format":"int64","description":"符合条件的节点总数。"},"count":{"type":"integer","format":"int64","description":"与 total 相同。"},"page":{"type":"integer","description":"当前页码。"},"page_size":{"type":"integer","description":"实际每页条数。"}}},"message":{"type":"string","description":"响应消息。"},"timestamp":{"type":"integer","format":"int64","description":"响应生成时间，Unix 秒。"}}}}}}}}}}}
```