Skip to main content
All list endpoints return paginated results using cursor-based pagination.

​
Basic usage

Control the number of results per page with the limit parameter (1–100, default 10): 
curl "https://api.altahq.com/v1/campaigns?limit=25" \
  -H "Authorization: Bearer YOUR_API_TOKEN"

​
Response format

Every list endpoint returns a response with pagination metadata: 
{
  "data": [...],
  "hasMore": true,
  "next": "eyJ2IjoxLCJ0IjoicGFnZS1iYXN..."
}
FieldTypeDescription
dataarrayThe list of objects for the current page
hasMorebooleanWhether there are more results after this page
nextstringCursor to fetch the next page
previousstringCursor to fetch the previous page

​
Fetching the next page

Pass the next value as cursor to fetch the next page: 
curl "https://api.altahq.com/v1/campaigns?cursor=eyJ2IjoxLCJ0IjoicGFnZS1iYXN..." \
  -H "Authorization: Bearer YOUR_API_TOKEN"
Cursors are tied to the original query filters. You cannot change filters between pages - doing so returns an error.

​
Example: iterating through all results

const API_URL = "https://api.altahq.com/v1/campaigns";
const headers = { Authorization: "Bearer YOUR_API_TOKEN" };

async function fetchAllCampaigns() {
  const allCampaigns = [];
  let params = new URLSearchParams({ limit: "50" });

  while (true) {
    const response = await fetch(`${API_URL}?${params}`, { headers });
    const { data, hasMore, next } = await response.json();
    allCampaigns.push(...data);

    if (!hasMore) break;

    params = new URLSearchParams({ cursor: next });
  }

  console.log(`Fetched ${allCampaigns.length} campaigns`);
  return allCampaigns;
}