List routes
GET /v1/routes
Get a paginated list of routes.
Token scope required: routes:list
Request
Query Parameters
- includeCounts boolean
If true, return count of total records and current page start and count in metadata
- cursor string
Cursor value at which to start the results, provided in
nextCursor
orprevCursor
of a prior requestExample: bmV4dA.eyJsb2dzLmNyZQ5iIiwiX3ZhbHVlIjo9In19 - pageSize integer
Possible values:
<= 500
Default value:
25
Number of records to return in each page
- 200
Successful operation
- application/json
- Schema
- Example (from schema)
- includeCounts
Schema
data object[]
Array [id stringname stringdescription stringcreatedAt date-timemodifiedAt date-timerouterHostID stringroutableCIDRs object
Keys of object should be IPv4 CIDR ranges, values are an object with an 'install' boolean.
property name* object
install booleanfirewallRulesCount number]metadata object
totalCount integerThe total number of resources existing in the account
hasNextPage booleanIs there a page of data that can be fetched using the
nextCursor
?hasPrevPage booleanIs there a page of data that can be fetched using the
prevCursor
?nextCursor stringAn opaque string that can be used to fetch the next page of results. Not provided if result set is empty.
prevCursor stringAn opaque string that can be used to fetch the next page of results. Not provided if result set is empty.
page object
count integer requiredThe number of results returned in the response.
start integer requiredThe zero-based index of the first result within the overall list. For example, the first page will have a
start
of0
. If 25 results are fetched, and thenextCursor
used to fetch a new page of results, the second request'sstart
will be25
.
{
"data": [
{
"id": "string",
"name": "string",
"description": "string",
"createdAt": "2024-03-29T16:40:56.604Z",
"modifiedAt": "2024-03-29T16:40:56.604Z",
"routerHostID": "string",
"routableCIDRs": {},
"firewallRulesCount": 0
}
],
"metadata": {
"totalCount": 0,
"hasNextPage": true,
"hasPrevPage": true,
"nextCursor": "string",
"prevCursor": "string",
"page": {
"count": 0,
"start": 0
}
}
}
Metadata returned when including request params for includeCounts=true
, pageSize=1
, and cursor="somevalue"
.
{
"data": [
{
"id": "route-X47KHSCOSQJP5IOKNNKRRGHVAI",
"name": "My first route",
"description": "",
"routerHostID": "host-24NVITKMNU3CYCEDNFWKAOBX7I",
"routableCIDRs": {
"192.168.14.0/26": {
"install": true
}
},
"createdAt": "2024-03-10T13:59:09Z",
"modifiedAt": "2024-03-15T13:59:09Z",
"firewallRulesCount": 1
}
],
"metadata": {
"totalCount": 500,
"hasNextPage": true,
"hasPrevPage": true,
"prevCursor": "cHJldg.SI6ImIiLCJfdmFsdWUiOiI0dDVuREQreU",
"nextCursor": "bmV4dA.bHVlIjoieGJVS0UvYkRjQmZsY1pUbGJCc",
"page": {
"count": 1,
"start": 5
}
}
}