Skip to main content
GET
Get webhook event & monitor payload details
Free - does not consume credits
The Node.js, Python, and Go examples convert one event into an audit row. Store event_id, monitor_type, monitor_id, event_type, occurred_at, x_event_id, tweet fields from data, event_detail_endpoint, and delivery_join_key; keyword monitor events use keyword_monitor_id and query instead of username.

Event detail handoff

Use this endpoint after list or delivery workflows find an event that needs full tweet data, author context, or support/audit review.

Detail row

Store event_id, event_type, occurred_at, event_detail_endpoint, and delivery_join_key. Keep event_id as the Xquik event identifier.

Delivery join

Match delivery_join_key to webhook delivery streamEventId from List Deliveries. Do not use x_event_id for delivery joins.

Monitor source

Store monitor_type, monitor_id, keyword_monitor_id, username, and query so account and keyword monitor audits stay separate.

Tweet payload

Store x_event_id, tweet_id, tweet_text, and author_username from data when the event contains tweet content.

Delivery status

After joining deliveries, attach status, attempts, lastStatusCode, lastError, createdAt, and deliveredAt to the event detail row.

Path parameters

string
required
The event ID to retrieve.

Headers

string
required
Your API key.

Response

200 OK

string
Unique event identifier.
string
Event type (e.g. tweet.new, tweet.reply, tweet.quote, tweet.retweet).
string
Account monitor ID for account events, or keyword monitor ID for keyword events.
string
Source type: account or keyword.
string
Keyword monitor ID. Present only for keyword monitor events.
string
X username that triggered the event. Present only for account monitor events.
string
Keyword query that matched the event. Present only for keyword monitor events.
string
ISO 8601 timestamp of when the event occurred on X.
object
Tweet object stored with the monitor event. Fields vary by event type. See Webhooks Overview.
string
X platform tweet ID associated with this event. Present only for tweet events.

401 Unauthenticated

Missing or invalid API key. Check the x-api-key header value.

400 Invalid ID

The provided event ID is not a valid format.

404 Not found

No event exists with this ID, or it belongs to a different account.

429 Rate limited

Too many requests. Wait for the Retry-After header before retrying.