Skip to main content
GET
Retrieve the current IP access policy of a single API key, that is, the list of source IPs allowed to use the key. If the key has never been configured, an empty list is returned, meaning the source IP is not restricted.
The IP access policy applies to model invocation endpoints only. When the source IP of a request is not in the allowed list, the model call is rejected; management endpoints (including these IP access policy read/write endpoints, billing queries, Sandbox, etc.) are not restricted by source IP.

Permissions

The target API key must belong to the caller’s team. When querying a key that the caller has no permission for or that does not belong to the team, the endpoint does not reveal whether the target key exists and returns a permission error uniformly.

Request Headers

string
required
Bearer authentication format, for example: Bearer {{API Key}}.

Path Parameters

string
required
The stringId of the target API key.

Response Parameters

string
required
The stringId of the API key.
object
required
The IP access policy object.
string
required
Policy status. Value: active.
int
required
The number of allowed IP entries. 0 means the source IP is not restricted.
string
required
The last update time, in ISO 8601 format. Empty string if never configured.
string
required
The user UUID of the last operator. Empty string if never configured.
Last modified on September 1, 2026