Favorites

Get a favorite

Retrieve a single favorite by its unique ID. Returns `{ data: { favorite: {...} } }`. The polymorphic target — exactly one of `group_id`, `view_id`, or `contact_id` — is on the favorite body; relation

GET /v2/favorites/{favoriteId}

Parameters

Path parameters

favoriteId

string (uuid) required

Responses

200 — Successful response

Content-Type: application/json

data

object required

data.favorite

object required

data.favorite.id

string (uuid) required

data.favorite.user_id

string

data.favorite.group_id

string (uuid) | null

data.favorite.view_id

string (uuid) | null

data.favorite.contact_id

string (uuid) | null

data.favorite.ranking

integer | null

data.favorite.created_at

string (date-time) required

data.favorite.updated_at

string (date-time) required

data.favorite.groups

object | null

data.favorite.views

object | null

data.favorite.contacts

object | null

Example

{
  "data": {
    "favorite": {
      "id": "00000000-0000-0000-0000-000000000000",
      "created_at": "2026-08-21T15:31:00.973Z",
      "updated_at": "2026-08-21T15:31:00.973Z"
    }
  }
}

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/favorites/00000000-0000-0000-0000-000000000000 \
  --header 'Authorization: Bearer YOUR_API_KEY'

fetch('https://api.prod.getdex.com/v2/favorites/00000000-0000-0000-0000-000000000000', {
  headers: {
    Authorization: 'Bearer YOUR_API_KEY'
  }
})

requests.get(
    "https://api.prod.getdex.com/v2/favorites/00000000-0000-0000-0000-000000000000",
    headers={
      "Authorization": "Bearer YOUR_API_KEY"
    }
)

Search contacts, full

Full-capability contact search: free-text across seven fields with accent folding and similarity ranking, an optional geographic `near` radius, group/archive filters, and an empty-query mode that list

Update a favorite

Partial update of a favorite. Only `ranking` is mutable — the polymorphic target (group / view / contact) is fixed once the row is created. **Requires `Idempotency-Key`.** Returns `{ data: { favorite: