Skip to main content
GET https://xquik.com/api/v1/events/{id}
Free. This endpoint does not consume credits.
Account events include the current username and permanent xUserId. Use xUserId to match an account after its username changes. monitorName is your monitor label when Xquik created the event. A rename leaves past events unchanged. MCP returns x_user_id, monitor_name, and prefixed monitor_id values.
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. Use it for full tweet data, author context, or a support or 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. That keeps account and keyword monitor audits separate.

Tweet payload

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

Delivery status

Join deliveries first. Then attach status, attempts, lastStatusCode, lastError, createdAt, and deliveredAt to the event detail row.

Path parameters

Headers

Response

200 OK

401 Unauthenticated

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

400 Invalid ID

{ "error": "invalid_id", "message": "Invalid ID format." } 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

{ "error": "rate_limit_exceeded", "message": "Too many requests. Try again later.", "retryAfter": 1 } Too many requests. Wait for the Retry-After header before retrying.

Response examples

  • 400 { "error": "invalid_input", "message": "Invalid input. Check the request body." }
  • 401 { "error": "unauthenticated", "message": "Authentication required. Provide a valid API key or bearer token." }
  • 403 { "error": "api_key_paused", "message": "This API key is paused. Resume it at dashboard.xquik.com/api-keys to use it again." }
  • 404 { "error": "not_found", "message": "Resource not found." }
  • 429 { "error": "rate_limit_exceeded", "message": "Too many requests. Try again later.", "retryAfter": 60 }