Contacts

Get Contact Timeline

The funnel timeline for one contact: what was done, what it cost, what came back.

Read-only. Tenancy: the key's own organisation is the only schema read, and the contact must be visible to the key (id_kind="pk", the namespace the timeline sources are keyed on, so the gate authorises the same row the handler serves). Every step kind is present in a fixed order; count and cost_credits are null when not recorded, which is not the same as 0. Returns 404 for a contact outside the key's organisation or visibility and 504 when the read times out.

get/contacts/{contact_id}/timeline

Request

  • Base URL: https://be.graph8.com/api/v1
  • URL: https://be.graph8.com/api/v1/contacts/{contact_id}/timeline
  • Auth: HTTP bearer

Path parameters

contact_idinteger required

Contact primary key (mashup_contacts.id).

Headers

Authorizationstring nullable
X-Target-Org-Idstring nullable

Response

Successful Response

dataCrmRecordPayload required

An open envelope for one record, one dashboard or one job receipt.

Open because most of these reads are COMPUTED shapes - an engagement summary, a next-best-step, an intelligence status - that grow with the product, and dropping a field from an advisory read makes it say "nothing to report" rather than "we did not tell you".

Changes

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