**Version: 202601**

# List app proxies

**GET** `/openapi/2026-01/app-proxies`

Retrieves a paginated list of app proxy rules configured for the shop.

## Request

**Query Parameters**

- `page` int32

  Page number. Defaults to 1
- `limit` int32

  Number of app proxies returned per page. Defaults to 20 and cannot exceed 250

## Responses

**200**

OK

**application/json**

**Schema | Example**

**Schema**

- `code` string

  error code
- `message` string

  error message
- `data` object

  - `app_proxys` object[]

    List of app proxies

    *   Array \[

    - `id` int32

      Unique identifier of the app proxy
    - `real_path` string

      URL path configured for accessing the proxy. For example, use "pay" when the target path is "apps/pay"
    - `proxy_url` string

      URL of the developer's application that processes proxied requests, for example, "[http://www.example.com/app](http://www.example.com/app)"
    - `change_origin` boolean

      Whether to rewrite the request Host header to the proxy target
    - `created_at` string

      Timestamp when the app proxy was created
    - `updated_at` string

      Timestamp when the app proxy was last updated
    *   \]

```json
{
  "code": "string",
  "message": "string",
  "data": {
    "app_proxys": [
      {
        "id": 0,
        "real_path": "string",
        "proxy_url": "string",
        "change_origin": true,
        "created_at": "string",
        "updated_at": "string"
      }
    ]
  }
}
```