Pagination
The Cisco Secure Access API endpoints that list a collection also support pagination. Pagination is available for API endpoints within certain scopes.
Admin, Deployments, and Policies
You can set the limit and page request query parameters for the collection endpoints.
If you do not set the limit query parameter, Secure Access returns up to 200 records per request. The default page value is 1.
Pagination by endpoint:
api.secureaccessfed.cisco.com/deployments/v2/roamingcomputers- Maximum batch size is 100 records.
api.secureaccessfed.cisco.com/policies/v2/destinationlists/{destinationListId}/destinations- Maximum batch size is 100 records.
To get another batch size, set the limit query parameter. For example:
curl -L --location-trusted --request GET --url https://api.secureaccessfed.cisco.com/policies/v2/destinationlists/{destinationListId}/destinations?limit=25 \
-H 'Authorization: Bearer %YourAccessToken%' \
-H 'Content-Type: application/json'
Reports
You can control the number of records in the Secure Access Reporting API result set and manage how to read the collection with the limit and offset query parameters.
| Name | Type | Description |
|---|---|---|
| offset | number | The index or entry point into the collection. |
| limit | number | The number of returned items in the collection. |
The Secure Access for Government Reporting API endpoints provide query parameters to filter and customize requests. For more information, see Secure Access for Government Reporting API Query Parameters.