> ## Documentation Index
> Fetch the complete documentation index at: https://docs.go2proxy.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Dynamic Proxy Acquire

> Introduction to the Acquire Dynamic Proxy API Interface

<Note>The proxies extracted from the dynamic proxy API can only be used with whitelist authentication.</Note>

* API interface address：[https://api.go2proxy.com/v1/dynamic/proxies](https://api.go2proxy.com/v1/dynamic/proxies)

* Request Method：GET

* QPS Limit：Each order can be accessed once per second

## 1.Parameters

| Parameter | required | Type     | Description                                                |
| :-------- | :------- | :------- | :--------------------------------------------------------- |
| app\_id   | required | `string` | API Access Credentials: AppID                              |
| signature | required | `string` | API Access Credentials: AppSecret                          |
| orderid   | required | `string` | Order Number                                               |
| num       | required | `int`    | Number of proxy to Extract This Time（1-1000）               |
| period    | required | `int`    | Proxy Validity Period（1-30）                                |
| region    | optional | `string` | Country Code (Leave Blank for `Global Mixed Broadcasting`) |

## 2.Return Example

```python code example theme={null}
{
    "code": 0,
    "msg": "success",
    "data": {
        "count": 2,
        "proxy_list": [
            {
                "ip": "43.130.57.106",
                "port": 10001
            },
            {
                "ip": "43.130.57.106",
                "port": 10002
            }
        ]
    }
}
```

## 3.Return Parameter Description

| Parameter | Type        | Description                                                                                                           |
| :-------- | :---------- | :-------------------------------------------------------------------------------------------------------------------- |
| code      | `int`       | Request Business Status<br />A value of 0 signifies success <br />any value other than 0 indicates a business failure |
| msg       | `string`    | Request Business Description                                                                                          |
| data      | `"" or map` | Empty string if the request business fails                                                                            |