Platform
Pagination
List endpoints are cursor-paginated, newest first, as { data, nextCursor }. Pass the previous page's nextCursor to read on.
{ "data": [ … ], "nextCursor": "WyIyMDI2…" }limit: 1–100, default 25.cursor: the previous page'snextCursor; omit it for the first page.nextCursorisnullon 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.
curl 'https://api.trovacast.com/v1/messages?limit=50&cursor=NEXT_CURSOR' \
-H "Authorization: Bearer $TROVACAST_API_KEY"Reading every page with the SDKs
for await (const message of trovacast.paginate('listMessages', { query: { contactId } })) {
console.log(message.id, message.status);
}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.
curl 'https://api.trovacast.com/v1/contacts?updatedAfter=2026-11-04T00%3A00%3A00.000Z' \
-H "Authorization: Bearer $TROVACAST_API_KEY"