Conventions
General conventions we use in the upcoach API
The
filter query parameters can be used to add filtering to the result collection. You can use multiple filters at the same time.?filter[email][email protected]
&filter[id]=usr-1234-123-123-12345
All the endpoints returning a paginated result collection have the following response structure:
{
"data": [...], // Result collection
"links": {
"first": "...", // First page URL
"last": "...", // Last page URL
"prev": "...", // Previous page URL, can be null
"next": "..." // Next page URL, can be null
},
"meta": {
"current_page": 1, // Current page number
"from": 1, // Showing the results from index
"last_page": // Last page number,
"path": "...", // URL path to pagination
"per_page": 15, // Records per page
"to": 15, // Showing the results to index
"total": 21 // Total records
}
}
In order to simply paginate through records, all you need to do is to follow the
next and prev links in the response.The
sort query parameter is used to determine by which property the results collection will be ordered. Sorting is ascending by default and can be reversed by adding a hyphen (-) to the start of the property name.?sort=name
Last modified 1yr ago