Skip to Content
Drip Docs
Guides

Paging and polling

Read results page by page with next_cursor, and check for new updates with since_cursor.

Paging

Lists come back one page at a time, 25 items by default, or 10 when detail is full. Each response includes next_cursor. To get the next page, send it back as cursor. When next_cursor is null, you've reached the last page.

Updates, search, companies, and people all page the same way.

since sets the start of the window for updates. Use a date such as 2026-11-01, or 24h, 7d, or 30d. The window ends now unless you set until.

curl "https://api.joindrip.ai/v1/workspaces/$WORKSPACE_ID/updates?since=7d&limit=25" \
  -H "Authorization: Bearer $DRIP_API_KEY"
const base = `https://api.joindrip.ai/v1/workspaces/${process.env.WORKSPACE_ID}/updates`;
const headers = { Authorization: `Bearer ${process.env.DRIP_API_KEY}` };

const url = new URL(base);
url.searchParams.set("since", "7d");
url.searchParams.set("limit", "25");

let page = await (await fetch(url, { headers })).json();

while (page.next_cursor) {
  url.searchParams.set("cursor", page.next_cursor);
  page = await (await fetch(url, { headers })).json();
}

detail controls how much each item includes: headlines, compact, or full.

A window with nothing in it still returns HTTP 200. Check status in the response. See Errors.

Polling for new updates

To get only what's new since your last check, save the sync_cursor from an updates response and send it as since_cursor next time:

curl "https://api.joindrip.ai/v1/workspaces/$WORKSPACE_ID/updates?since_cursor=$SYNC_CURSOR" \
  -H "Authorization: Bearer $DRIP_API_KEY"

Each response returns a new sync_cursor. Save it for the next check.