# Get event's outbound IP

Feishu Open Platform sends events to the callback address configured for the app using specific IP addresses. Apps can use this interface to obtain all related IP addresses.

**Notice**：IP addresses may change, so it is recommended to regularly fetch the latest IP addresses and automatically update them in the firewall rules. Additionally, when IP changes occur, the Open Platform will push card messages and publish update logs to notify developers.

## Request

Facts | &nbsp;
---|---
HTTP URL | https://open.feishu.cn/open-apis/event/v1/outbound_ip
HTTP Method | GET
Supported app types | Custom App、Store App
Required scopes<br>**To use this API, you must have at least 1 of the listed scopes.** | Get event's outbound IP address(event:ip_list)

### Request header

Parameter | Type | Required | Description
---|---|---|---
Authorization | string | Yes | `tenant_access_token`<br>**Value format**: "Bearer `access_token`"<br>**Example value**: "Bearer t-7f1bcd13fc57d46bac21793a18e560"<br>[How to choose and get access token](https://open.feishu.cn/document/uAjLw4CM/ugTN1YjL4UTN24CO1UjN/trouble-shooting/how-to-choose-which-type-of-token-to-use)

### Query parameters

Parameter | Type | Required | Description
---|---|---|---
page_size | int | No | Page size<br>**Example value**: 10<br>**Data validation rules**:<br>- Maximum value: `50`
page_token | string | No | Page identifier. It is not filled in the first request, indicating traversal from the beginning; when there will be more groups, the new page_token will be returned at the same time, and the next traversal can use the page_token to get more groups<br>**Example value**: "AQD9/Rn9eij9Pm39ED40/dk53s4Ebp882DYfFaPFbz00L4CMZJrqGdzNyc8BcZtDbwVUvRmQTvyMYicnGWrde9X56TgdBuS+JKiSIkdexPw="

## Response

### Response body

Parameter | Type | Description
---|---|---
code | int | Error codes, fail if not zero
msg | string | Error descriptions
data | \- | \-
ip_list | string\[\] | outbound ip
page_token | string | Page identifier, when has_more is true, a new page_token will also be returned. Otherwise, page_token will not be returned
has_more | boolean | Whether the response body has more parameters

### Response body example
```json
{
    "code": 0,
    "msg": "success",
    "data": {
        "ip_list": [
            "1.1.1.1"
        ],
        "page_token": """",
        "has_more": false
    }
}
```

### Error code

HTTP status code | Error code | Description | Troubleshooting suggestions
---|---|---|---
400 | 1810001 | param is invalid | check params

