Unified Timeline

Get unified timeline

Retrieve a unified, paginated timeline combining notes, reminders, emails, and calendar events. Supports filtering by source type, contact, date range, and text search.

GET /v1/unified-timeline/

Parameters

Query parameters

sources

string

contactId

string (uuid)

take

integer

cursor

string

startDate

string

endDate

string

upcoming

boolean

searchQuery

string

includeContactDetails

boolean

Responses

200 — Successful response

Content-Type: application/json

error

boolean required

data

object required

data.items

array<object> required

data.items[].type

string enum required

Possible values: "NOTE"

data.items[].date

string required

data.items[].data

object required

data.items[].data.id

string (uuid) required

data.items[].data.user_id

string

data.items[].data.note

string | null

data.items[].data.custom_emoji

string | null

data.items[].data.meeting_type

string | null

data.items[].data.meeting_type_id

string (uuid) | null

data.items[].data.event_time

string (date-time)

data.items[].data.created_at

string (date-time)

data.items[].data.google_calendar_event_id_v3

string | null

data.items[].data.oauth_credential_id

string (uuid) | null

data.items[].data.calendar_account_email

string | null

data.items[].data.calendar_account_provider

string enum

Possible values: "GOOGLE", "OFFICE365"

data.items[].data.reminder_id

string (uuid) | null

data.items[].data.channels

array<string enum> required

data.items[].data.next_cursor

string

data.items[].data.meeting_types

object | null required

data.items[].data.timeline_items_contacts

array<object>

data.items[].data.attachments

array<object>

data.nextCursor

string | null required

data.hasMore

boolean required

data.count

integer required

data.timedOutSources

array<string enum> required

Example

{
  "error": false,
  "data": {
    "items": [
      {
        "type": "NOTE",
        "date": "string",
        "data": {
          "id": "00000000-0000-0000-0000-000000000000",
          "channels": [
            "whatsapp"
          ],
          "meeting_types": {}
        }
      }
    ],
    "nextCursor": "string",
    "hasMore": false,
    "count": 0,
    "timedOutSources": [
      "notes"
    ]
  }
}

400

No response body.

401

No response body.

403

No response body.

404

No response body.

429

No response body.

500

No response body.

Code samples

curl https://api.prod.getdex.com/v1/unified-timeline/ \
  --header 'Authorization: Bearer YOUR_API_KEY'

fetch('https://api.prod.getdex.com/v1/unified-timeline/', {
  headers: {
    Authorization: 'Bearer YOUR_API_KEY'
  }
})

requests.get(
    "https://api.prod.getdex.com/v1/unified-timeline/",
    headers={
      "Authorization": "Bearer YOUR_API_KEY"
    }
)

List note types

Retrieve all available note types (e.g., meeting, call, email, note). Use these types when creating or filtering notes.

Get current user

Retrieve the profile of the currently authenticated user. Returns account details including name, email, time zone, subscription plan, and onboarding status.