Get event

GET/v1/events/{evt}

Reads one event.

Behavior

An id belonging to another brand answers 404, never 403. The two are the same answer here, so this route cannot confirm an id exists elsewhere.

Path ParametersExpand Collapse

evt: string

ReturnsExpand Collapse

Event object { id, created_at, data, 5 more }

One event in your brand’s log.

The attribution is a typed pair: a chat event carries chat_id, an invitation_batch.* event carries batch_id, and exactly one of the two is present on any event. They are never both set and never interchangeable.

id: string

Stable id, evt_…. Unique for the life of the event.

created_at: string

When the event happened. For a chat event this is the instant the chat recorded it.

formatdate-time

data: unknown

The event body, exactly what a webhook delivery for this event carries, so the same parser reads both.

seq_from: number

First chat seq this event covers.

formatint64

seq_to: number

Last chat seq this event covers.

formatint64

type: string

What happened, e.g. message.received. The same names an endpoint subscribes to.

batch_id: optional string

The invitation-batch run this event belongs to. Present on invitation_batch.* events only.

chat_id: optional string

The chat this event belongs to, on chat events. A brand-scoped event (brand.escalation_handling_changed) carries its synthetic feed id here instead (brand:<brand_id>), which is load-bearing for ordering and dedup exactly as a chat id is.

Get event

curl https://messages.api.linqapp.com/v1/events/$EVT \
    -H "Authorization: Bearer $LINQ_AMB_API_KEY"

{
  "id": "evt_9c2f4a1b",
  "type": "message.received",
  "created_at": "2026-08-14T05:12:44Z",
  "data": {
    "body": "where is my driver?"
  },
  "chat_id": "chat_4f81b2",
  "seq_from": 13,
  "seq_to": 13
}

Returns Examples

{
  "id": "evt_9c2f4a1b",
  "type": "message.received",
  "created_at": "2026-08-14T05:12:44Z",
  "data": {
    "body": "where is my driver?"
  },
  "chat_id": "chat_4f81b2",
  "seq_from": 13,
  "seq_to": 13
}