Email

List contacts

The account's address book, auto-fed by mail traffic: correspondents, message counts, last activity, and notes. Most recently active first by default (order=recent), for display: a contact that gets new mail during a paged scan moves ahead of the cursor, so that scan can skip it. To sync the whole book, pass order=created: oldest first by creation time then id, a key that never changes, so every contact that exists for the whole scan comes back exactly once and contacts created meanwhile come at the end. A cursor only continues the order it came from (400 INVALID_CURSOR otherwise). Aggregates data from every mailbox, so mailbox-confined tokens are denied (400 MAILBOX_CONFINED).

get/api/contacts

Request

  • Base URL: https://domani.run
  • URL: https://domani.run/api/contacts
  • Auth: HTTP bearer

Query parameters

qstring

Filter by address or name substring

limitinteger

Contacts to return (default 50)

cursorstring

Pagination cursor from a previous response

order'recent' | 'created'

Sort order. recent (default): most recently active first, for display. created: oldest first by creation time then id, stable for a full scan. Any other value is 400 INVALID_ORDER.

Response

Contacts

next_cursorstring nullable

Changes

No recorded changes to this operation across all 2 revisions of this API.