Skip to main content

​
Request parameters

ParameterTypeDefaultRangeWhat it does
limitinteger201–100How many results to return per page
offsetinteger00+How many results to skip before starting the page

​
Response metadata

Every paginated response includes a meta.pagination object that tells you where you are in the result set: 
{
  "data": [ ... ],
  "meta": {
    "pagination": {
      "totalCount": 142,
      "hasMore": true,
      "limit": 20,
      "offset": 0
    }
  }
}
FieldTypeWhat it tells you
totalCountintegerTotal results across all pages
hasMorebooleanWhether there are more pages after this one
limitintegerPage size (echoed from your request)
offsetintegerCurrent position in the result set

​
Which endpoints are paginated?

EndpointWhat it returns
GET /slice-runsRun history for your team
POST /posts/searchSummaries and scorecards matching your filters
All other endpoints return the full result set in a single response.

​
Fetching all pages

Use the hasMore field to loop through pages. Increment offset by limit each time until hasMore is false. 
# First page
curl "https://app.oneperfectslice.ai/api/public/v1/slice-runs?limit=20&offset=0" \
  -H "Authorization: Bearer sk_your_api_key"

# Second page
curl "https://app.oneperfectslice.ai/api/public/v1/slice-runs?limit=20&offset=20" \
  -H "Authorization: Bearer sk_your_api_key"