List usage limits policy entities

cURL

curl --request GET \
  --url https://api.apps.paloaltonetworks.com/ai_gw/v2/policies/usage-limits/{policyUsageLimitsId}/entities \
  --header 'Authorization: Bearer <token>'

import requests

url = "https://api.apps.paloaltonetworks.com/ai_gw/v2/policies/usage-limits/{policyUsageLimitsId}/entities"

headers = {"Authorization": "Bearer <token>"}

response = requests.get(url, headers=headers)

print(response.text)

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://api.apps.paloaltonetworks.com/ai_gw/v2/policies/usage-limits/{policyUsageLimitsId}/entities', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.apps.paloaltonetworks.com/ai_gw/v2/policies/usage-limits/{policyUsageLimitsId}/entities",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.apps.paloaltonetworks.com/ai_gw/v2/policies/usage-limits/{policyUsageLimitsId}/entities"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.get("https://api.apps.paloaltonetworks.com/ai_gw/v2/policies/usage-limits/{policyUsageLimitsId}/entities")
  .header("Authorization", "Bearer <token>")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.apps.paloaltonetworks.com/ai_gw/v2/policies/usage-limits/{policyUsageLimitsId}/entities")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body

{
  "object": "<string>",
  "data": [
    {
      "id": "<string>",
      "value_key": "<string>",
      "current_usage": 123
    }
  ],
  "total": 123
}

GET

policies

usage-limits

{policyUsageLimitsId}

entities

cURL

curl --request GET \
  --url https://api.apps.paloaltonetworks.com/ai_gw/v2/policies/usage-limits/{policyUsageLimitsId}/entities \
  --header 'Authorization: Bearer <token>'

import requests

url = "https://api.apps.paloaltonetworks.com/ai_gw/v2/policies/usage-limits/{policyUsageLimitsId}/entities"

headers = {"Authorization": "Bearer <token>"}

response = requests.get(url, headers=headers)

print(response.text)

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://api.apps.paloaltonetworks.com/ai_gw/v2/policies/usage-limits/{policyUsageLimitsId}/entities', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.apps.paloaltonetworks.com/ai_gw/v2/policies/usage-limits/{policyUsageLimitsId}/entities",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.apps.paloaltonetworks.com/ai_gw/v2/policies/usage-limits/{policyUsageLimitsId}/entities"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.get("https://api.apps.paloaltonetworks.com/ai_gw/v2/policies/usage-limits/{policyUsageLimitsId}/entities")
  .header("Authorization", "Bearer <token>")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.apps.paloaltonetworks.com/ai_gw/v2/policies/usage-limits/{policyUsageLimitsId}/entities")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body

{
  "object": "<string>",
  "data": [
    {
      "id": "<string>",
      "value_key": "<string>",
      "current_usage": 123
    }
  ],
  "total": 123
}

Authorizations

Authorization

string

header

required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

policyUsageLimitsId

string<uuid>

required

Query Parameters

status

enum<string>

Available options:

active,

exhausted

string

page_size

integer

Required range: 1 <= x <= 100

current_page

integer

Required range: x >= 0

Response

object

string

data

object[]

Show child attributes

total

integer

Last modified on September 17, 2026

API Reference

Gateway Configuration

Providers and Credentials

MCP

Administration

Observability

List usage limits policy entities

Authorizations

Path Parameters

Query Parameters

Response