Timeline

Search notes

Full-text search over the notes you own. Matches on the note body and on the names of contacts each note is linked to. Returns the canonical notes list envelope, cursor-paginated.

GET /v2/timeline/notes/search

Parameters

Query parameters

searchQuery
string
contactId
string (uuid)
startDate
string
endDate
string
take
integer
cursor
string
includeContactDetails
boolean
groupId
string (uuid)

Responses

200 — Successful response

Content-Type: application/json

data
object required
data.notes
array<object> required
data.notes[].id
string (uuid) required
data.notes[].user_id
string
data.notes[].note
string | null
data.notes[].custom_emoji
string | null
data.notes[].meeting_type
string | null
data.notes[].meeting_type_id
string (uuid) | null
data.notes[].event_time
string (date-time)
data.notes[].created_at
string (date-time)
data.notes[].google_calendar_event_id_v3
string | null
data.notes[].oauth_credential_id
string (uuid) | null
data.notes[].calendar_account_email
string | null
data.notes[].calendar_account_provider
string enum
Possible values: "GOOGLE", "OFFICE365"
data.notes[].reminder_id
string (uuid) | null
data.notes[].channels
array<string enum> required
data.notes[].next_cursor
string
data.notes[].meeting_types
object | null required
data.notes[].timeline_items_contacts
array<object>
data.notes[].attachments
array<object>
data.pagination
object
data.pagination.nextCursor
string | null
data.pagination.count
integer

Example

{
  "data": {
    "notes": [
      {
        "id": "00000000-0000-0000-0000-000000000000",
        "channels": [
          "whatsapp"
        ],
        "meeting_types": {}
      }
    ]
  }
}

400

No response body.

401

No response body.

403

No response body.

404

No response body.

409

No response body.

429

No response body.

500

No response body.

Code samples

curl https://api.prod.getdex.com/v2/timeline/notes/search \
  --header 'Authorization: Bearer YOUR_API_KEY'
Copyright © 2026