--- title: List IP profiles --- [Skip to content](#_top) [API Reference](https://developers.cloudflare.com/api/typescript) [Zero Trust](https://developers.cloudflare.com/api/typescript/resources/zero_trust) [Devices](https://developers.cloudflare.com/api/typescript/resources/zero_trust/subresources/devices) [IP Profiles](https://developers.cloudflare.com/api/typescript/resources/zero_trust/subresources/devices/subresources/ip_profiles) Copy Markdown Open in **Claude**Open in **ChatGPT**Open in **Cursor** --- **Copy Markdown****View as Markdown** # List IP profiles client.zeroTrust.devices.ipProfiles.list(IPProfileListParams {account\_id, page, per\_page } params, RequestOptionsoptions?): V4PagePaginationArray< [IPProfile]() {id, created\_at, description, 6 more } > GET/accounts/{account\_id}/devices/ip-profiles Lists WARP Device IP profiles. ##### Security API Token The preferred authorization scheme for interacting with the Cloudflare API. [Create a token](https://developers.cloudflare.com/fundamentals/api/get-started/create-token/). **Example:**`Authorization: Bearer Sn3lZJTBX6kkg7OdcBUAxOO963GEIyGQqnFTOFYY` ##### Accepted Permissions (at least one required) `Zero Trust Read``Zero Trust Write` ##### ParametersExpand Collapse

params: IPProfileListParams {account\_id, page, per\_page }

account\_id: string Path param Link to this property page?: number Query param: The page number to return. minimum1 Link to this property per\_page?: number Query param: The number of IP profiles to return per page. maximum100 minimum1 Link to this property

[Link to this property](<#(resource)%20zero_trust.devices.ip_profiles%20%3E%20(method)%20list%20%3E%20(params)%20default>) ##### ReturnsExpand Collapse

IPProfile {id, created\_at, description, 6 more }

id: string The ID of the Device IP profile. Link to this property created\_at: string The RFC3339Nano timestamp when the Device IP profile was created. Link to this property description: string| null An optional description of the Device IP profile. Link to this property enabled: boolean Whether the Device IP profile is enabled. Link to this property match: string The wirefilter expression to match registrations. Available values: “identity.name”, “identity.email”, “identity.groups.id”, “identity.groups.name”, “identity.groups.email”, “identity.saml\_attributes”. maxLength10000 Link to this property name: string A user-friendly name for the Device IP profile. Link to this property precedence: number The precedence of the Device IP profile. Lower values indicate higher precedence. Device IP profile will be evaluated in ascending order of this field. Link to this property subnet\_id: string The ID of the Subnet. Link to this property updated\_at: string The RFC3339Nano timestamp when the Device IP profile was last updated. Link to this property

[Link to this property](<#(resource)%20zero_trust.devices.ip_profiles%20%3E%20(model)%20ip_profile%20%3E%20(schema)>) ### List IP profiles TypeScript HTTPTypeScriptPythonGoTerraform ``` import Cloudflare from 'cloudflare'; const client = new Cloudflare({ apiToken: process.env['CLOUDFLARE_API_TOKEN'], // This is the default and can be omitted }); // Automatically fetches more pages as needed. for await (const ipProfile of client.zeroTrust.devices.ipProfiles.list({ account_id: 'account_id', })) { console.log(ipProfile.id); } ``` 200 example ``` { "errors": [ { "code": 0, "message": "message" } ], "messages": [ { "code": 0, "message": "message" } ], "result": [ { "id": "f70ff985-a4ef-4643-bbbc-4a0ed4fc8415", "created_at": "2025-02-14T13:17:00.123456789Z", "description": "example comment", "enabled": true, "match": "identity.email == \"test@cloudflare.com\"", "name": "IPv4 Cloudflare Source IPs", "precedence": 100, "subnet_id": "b70ff985-a4ef-4643-bbbc-4a0ed4fc8415", "updated_at": "2025-02-14T13:17:00.123456789Z" } ], "success": true, "result_info": { "count": 1, "page": 1, "per_page": 10, "total_count": 10, "total_pages": 1 } } ``` ##### Returns Examples 200 example ``` { "errors": [ { "code": 0, "message": "message" } ], "messages": [ { "code": 0, "message": "message" } ], "result": [ { "id": "f70ff985-a4ef-4643-bbbc-4a0ed4fc8415", "created_at": "2025-02-14T13:17:00.123456789Z", "description": "example comment", "enabled": true, "match": "identity.email == \"test@cloudflare.com\"", "name": "IPv4 Cloudflare Source IPs", "precedence": 100, "subnet_id": "b70ff985-a4ef-4643-bbbc-4a0ed4fc8415", "updated_at": "2025-02-14T13:17:00.123456789Z" } ], "success": true, "result_info": { "count": 1, "page": 1, "per_page": 10, "total_count": 10, "total_pages": 1 } } ```