Skip to main content
GET
/
v1
/
endpoints
/
{endpointId}
/
events
/
tail
Pull a watermark-bounded forward page of events (cursor-pull tail)
curl --request GET \
  --url https://api.webhook.co/v1/endpoints/{endpointId}/events/tail \
  --header 'Authorization: Bearer <token>'
{
  "items": [
    {
      "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "orgId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "endpointId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "receivedAt": "2023-11-07T05:31:56Z",
      "dedupKey": "<string>",
      "verified": true
    }
  ],
  "nextCursor": "<string>",
  "headCursor": "<string>",
  "caughtUp": true,
  "lag": {
    "backlogCount": 4503599627370495,
    "headLagMs": 4503599627370495
  }
}

Authorizations

Authorization
string
header
required

A whk_-prefixed API key (opaque; not a JWT).

Path Parameters

endpointId
string<uuid>
required
Pattern: ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$

Query Parameters

sinceCursor
string

Opaque cursor to resume from (mutually exclusive with since).

since
string

Server-resolved grammar: now | beginning | | .

Response

Success.

items
object[]
required
nextCursor
string | null
required
headCursor
string | null
caughtUp
boolean
lag
object