Alta API Documentation

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..."
}

Field	Type	Description
`data`	`array`	The list of objects for the current page
`hasMore`	`boolean`	Whether there are more results after this page
`next`	`string`	Cursor to fetch the next page
`previous`	`string`	Cursor 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;
}