Trovacast

Platform

Pagination

List endpoints are cursor-paginated, newest first, as { data, nextCursor }. Pass the previous page's nextCursor to read on.

A page (json)
{ "data": [ … ], "nextCursor": "WyIyMDI2…" }
  • limit: 1–100, default 25.
  • cursor: the previous page's nextCursor; omit it for the first page.
  • nextCursor is null on the last page.
  • Treat the cursor as opaque. Pages are keyset-based, so rows arriving between calls never cause duplicates or gaps in what you have already read.
The next page of messages
curl 'https://api.trovacast.com/v1/messages?limit=50&cursor=NEXT_CURSOR' \
  -H "Authorization: Bearer $TROVACAST_API_KEY"

Reading every page with the SDKs

Node.js (javascript)
for await (const message of trovacast.paginate('listMessages', { query: { contactId } })) {
  console.log(message.id, message.status);
}
Python (python)
for message in client.paginate("list_messages", contact_id=contact_id):
    print(message["id"], message["status"])

Changes since a moment

Messages, calls and contacts also answer updatedAfter: every record that changed since a moment, oldest change first — the read to reconcile from after an outage, alongside missed events.

Contacts changed since a moment
curl 'https://api.trovacast.com/v1/contacts?updatedAfter=2026-11-04T00%3A00%3A00.000Z' \
  -H "Authorization: Bearer $TROVACAST_API_KEY"