Sign in
Events

Get event

Returns one monitor event owned by the account.

get/api/v1/events/{id}

Path parameters

idstring required

Resource ID returned by the matching create or list endpoint.

Response

Event details

idstring required
type'tweet.new' | 'tweet.reply' | 'tweet.retweet' | 'tweet.quote' | 'tweet.media' | 'tweet.link' | 'tweet.poll' | 'tweet.mention' | 'tweet.hashtag' | 'tweet.longform' | 'profile.avatar.changed' | 'profile.banner.changed' | 'profile.name.changed' | 'profile.username.changed' | 'profile.bio.changed' | 'profile.location.changed' | 'profile.url.changed' | 'profile.verified.changed' | 'profile.protected.changed' | 'profile.pinned_tweet.changed' | 'profile.unavailable.changed' required

Type of monitor event fired when account activity occurs.

usernamestring

Account username for this detailed monitor event.

querystring

Keyword query for this detailed monitor event.

monitorIdstring required

Monitor ID associated with this detailed event payload.

monitorType'account' | 'keyword' required

Source monitor type for this detailed event.

keywordMonitorIdstring

Keyword monitor ID included on detailed keyword events.

occurredAtstring date-time required
dataPublicMetadata required

Public metadata whose fields are defined by X.

xEventIdstring

Example response

{
  "id": "42",
  "type": "tweet.new",
  "username": "elonmusk",
  "query": "xquik OR \"x api\"",
  "monitorId": "10",
  "monitorType": "account",
  "keywordMonitorId": "21",
  "occurredAt": "2025-01-15T12:00:00Z",
  "data": {},
  "xEventId": "1234567890"
}

Changes

Changed in 2 of the 19 revisions of this API.120

  • 5d4938bb7de390See the full diff
    • ●

      added the new closed enum value to the allOf[Error]/error/oneOf[subschema #1: LegacyErrorCode]/ response property for the response status 429

      response-property-enum-value-added

    • ●

      added the new closed enum value to the allOf[Error]/error/oneOf[subschema #2: StructuredError]/code response property for the response status 429

      response-property-enum-value-added

    • ●

      added the new closed enum value to the error/oneOf[subschema #1: LegacyErrorCode]/ response property for the response status 400

      response-property-enum-value-added

    • ●

      added the new closed enum value to the error/oneOf[subschema #1: LegacyErrorCode]/ response property for the response status 401

      response-property-enum-value-added

    • ●

      added the new closed enum value to the error/oneOf[subschema #1: LegacyErrorCode]/ response property for the response status 404

      response-property-enum-value-added

    • ●

      added the new closed enum value to the error/oneOf[subschema #1: LegacyErrorCode]/ response property for the response status default

      response-property-enum-value-added

    • ●

      added the new closed enum value to the error/oneOf[subschema #2: StructuredError]/code response property for the response status 400

      response-property-enum-value-added

    • ●

      added the new closed enum value to the error/oneOf[subschema #2: StructuredError]/code response property for the response status 401

      response-property-enum-value-added

    • ●

      added the new closed enum value to the error/oneOf[subschema #2: StructuredError]/code response property for the response status 404

      response-property-enum-value-added

    • ●

      added the new closed enum value to the error/oneOf[subschema #2: StructuredError]/code response property for the response status default

      response-property-enum-value-added

    • ●

      added the new expired enum value to the allOf[Error]/error/oneOf[subschema #1: LegacyErrorCode]/ response property for the response status 429

      response-property-enum-value-added

    • ●

      added the new expired enum value to the allOf[Error]/error/oneOf[subschema #2: StructuredError]/code response property for the response status 429

      response-property-enum-value-added

    • ●

      added the new expired enum value to the error/oneOf[subschema #1: LegacyErrorCode]/ response property for the response status 400

      response-property-enum-value-added

    • ●

      added the new expired enum value to the error/oneOf[subschema #1: LegacyErrorCode]/ response property for the response status 401

      response-property-enum-value-added

    • ●

      added the new expired enum value to the error/oneOf[subschema #1: LegacyErrorCode]/ response property for the response status 404

      response-property-enum-value-added

    • ●

      added the new expired enum value to the error/oneOf[subschema #1: LegacyErrorCode]/ response property for the response status default

      response-property-enum-value-added

    • ●

      added the new expired enum value to the error/oneOf[subschema #2: StructuredError]/code response property for the response status 400

      response-property-enum-value-added

    • ●

      added the new expired enum value to the error/oneOf[subschema #2: StructuredError]/code response property for the response status 401

      response-property-enum-value-added

    • ●

      added the new expired enum value to the error/oneOf[subschema #2: StructuredError]/code response property for the response status 404

      response-property-enum-value-added

    • ●

      added the new expired enum value to the error/oneOf[subschema #2: StructuredError]/code response property for the response status default

      response-property-enum-value-added

    • ●

      added the new invalid_complete_replies_request enum value to the allOf[Error]/error/oneOf[subschema #1: LegacyErrorCode]/ response property for the response status 429

      response-property-enum-value-added

    • ●

      added the new invalid_complete_replies_request enum value to the allOf[Error]/error/oneOf[subschema #2: StructuredError]/code response property for the response status 429

      response-property-enum-value-added

    • ●

      added the new invalid_complete_replies_request enum value to the error/oneOf[subschema #1: LegacyErrorCode]/ response property for the response status 400

      response-property-enum-value-added

    • ●

      added the new invalid_complete_replies_request enum value to the error/oneOf[subschema #1: LegacyErrorCode]/ response property for the response status 401

      response-property-enum-value-added

    • ●

      added the new invalid_complete_replies_request enum value to the error/oneOf[subschema #1: LegacyErrorCode]/ response property for the response status 404

      response-property-enum-value-added

    • ●

      added the new invalid_complete_replies_request enum value to the error/oneOf[subschema #1: LegacyErrorCode]/ response property for the response status default

      response-property-enum-value-added

    • ●

      added the new invalid_complete_replies_request enum value to the error/oneOf[subschema #2: StructuredError]/code response property for the response status 400

      response-property-enum-value-added

    • ●

      added the new invalid_complete_replies_request enum value to the error/oneOf[subschema #2: StructuredError]/code response property for the response status 401

      response-property-enum-value-added

    • ●

      added the new invalid_complete_replies_request enum value to the error/oneOf[subschema #2: StructuredError]/code response property for the response status 404

      response-property-enum-value-added

    • ●

      added the new invalid_complete_replies_request enum value to the error/oneOf[subschema #2: StructuredError]/code response property for the response status default

      response-property-enum-value-added

    • ●

      added the new invalid_coverage_request enum value to the allOf[Error]/error/oneOf[subschema #1: LegacyErrorCode]/ response property for the response status 429

      response-property-enum-value-added

    • ●

      added the new invalid_coverage_request enum value to the allOf[Error]/error/oneOf[subschema #2: StructuredError]/code response property for the response status 429

      response-property-enum-value-added

    • ●

      added the new invalid_coverage_request enum value to the error/oneOf[subschema #1: LegacyErrorCode]/ response property for the response status 400

      response-property-enum-value-added

    • ●

      added the new invalid_coverage_request enum value to the error/oneOf[subschema #1: LegacyErrorCode]/ response property for the response status 401

      response-property-enum-value-added

    • ●

      added the new invalid_coverage_request enum value to the error/oneOf[subschema #1: LegacyErrorCode]/ response property for the response status 404

      response-property-enum-value-added

    • ●

      added the new invalid_coverage_request enum value to the error/oneOf[subschema #1: LegacyErrorCode]/ response property for the response status default

      response-property-enum-value-added

    • ●

      added the new invalid_coverage_request enum value to the error/oneOf[subschema #2: StructuredError]/code response property for the response status 400

      response-property-enum-value-added

    • ●

      added the new invalid_coverage_request enum value to the error/oneOf[subschema #2: StructuredError]/code response property for the response status 401

      response-property-enum-value-added

    • ●

      added the new invalid_coverage_request enum value to the error/oneOf[subschema #2: StructuredError]/code response property for the response status 404

      response-property-enum-value-added

    • ●

      added the new invalid_coverage_request enum value to the error/oneOf[subschema #2: StructuredError]/code response property for the response status default

      response-property-enum-value-added

    • ●

      added the new invalid_output_options enum value to the allOf[Error]/error/oneOf[subschema #1: LegacyErrorCode]/ response property for the response status 429

      response-property-enum-value-added

    • ●

      added the new invalid_output_options enum value to the allOf[Error]/error/oneOf[subschema #2: StructuredError]/code response property for the response status 429

      response-property-enum-value-added

    • ●

      added the new invalid_output_options enum value to the error/oneOf[subschema #1: LegacyErrorCode]/ response property for the response status 400

      response-property-enum-value-added

    • ●

      added the new invalid_output_options enum value to the error/oneOf[subschema #1: LegacyErrorCode]/ response property for the response status 401

      response-property-enum-value-added

    • ●

      added the new invalid_output_options enum value to the error/oneOf[subschema #1: LegacyErrorCode]/ response property for the response status 404

      response-property-enum-value-added

    • ●

      added the new invalid_output_options enum value to the error/oneOf[subschema #1: LegacyErrorCode]/ response property for the response status default

      response-property-enum-value-added

    • ●

      added the new invalid_output_options enum value to the error/oneOf[subschema #2: StructuredError]/code response property for the response status 400

      response-property-enum-value-added

    • ●

      added the new invalid_output_options enum value to the error/oneOf[subschema #2: StructuredError]/code response property for the response status 401

      response-property-enum-value-added

    • ●

      added the new invalid_output_options enum value to the error/oneOf[subschema #2: StructuredError]/code response property for the response status 404

      response-property-enum-value-added

    • ●

      added the new invalid_output_options enum value to the error/oneOf[subschema #2: StructuredError]/code response property for the response status default

      response-property-enum-value-added

    • ●

      added the new invalid_reply_options enum value to the allOf[Error]/error/oneOf[subschema #1: LegacyErrorCode]/ response property for the response status 429

      response-property-enum-value-added

    • ●

      added the new invalid_reply_options enum value to the allOf[Error]/error/oneOf[subschema #2: StructuredError]/code response property for the response status 429

      response-property-enum-value-added

    • ●

      added the new invalid_reply_options enum value to the error/oneOf[subschema #1: LegacyErrorCode]/ response property for the response status 400

      response-property-enum-value-added

    • ●

      added the new invalid_reply_options enum value to the error/oneOf[subschema #1: LegacyErrorCode]/ response property for the response status 401

      response-property-enum-value-added

    • ●

      added the new invalid_reply_options enum value to the error/oneOf[subschema #1: LegacyErrorCode]/ response property for the response status 404

      response-property-enum-value-added

    • ●

      added the new invalid_reply_options enum value to the error/oneOf[subschema #1: LegacyErrorCode]/ response property for the response status default

      response-property-enum-value-added

    • ●

      added the new invalid_reply_options enum value to the error/oneOf[subschema #2: StructuredError]/code response property for the response status 400

      response-property-enum-value-added

    • ●

      added the new invalid_reply_options enum value to the error/oneOf[subschema #2: StructuredError]/code response property for the response status 401

      response-property-enum-value-added

    • ●

      added the new invalid_reply_options enum value to the error/oneOf[subschema #2: StructuredError]/code response property for the response status 404

      response-property-enum-value-added

    • ●

      added the new invalid_reply_options enum value to the error/oneOf[subschema #2: StructuredError]/code response property for the response status default

      response-property-enum-value-added

    • ●

      added the new login_service_unavailable enum value to the allOf[Error]/error/oneOf[subschema #1: LegacyErrorCode]/ response property for the response status 429

      response-property-enum-value-added

    • ●

      added the new login_service_unavailable enum value to the allOf[Error]/error/oneOf[subschema #2: StructuredError]/code response property for the response status 429

      response-property-enum-value-added

    • ●

      added the new login_service_unavailable enum value to the error/oneOf[subschema #1: LegacyErrorCode]/ response property for the response status 400

      response-property-enum-value-added

    • ●

      added the new login_service_unavailable enum value to the error/oneOf[subschema #1: LegacyErrorCode]/ response property for the response status 401

      response-property-enum-value-added

    • ●

      added the new login_service_unavailable enum value to the error/oneOf[subschema #1: LegacyErrorCode]/ response property for the response status 404

      response-property-enum-value-added

    • ●

      added the new login_service_unavailable enum value to the error/oneOf[subschema #1: LegacyErrorCode]/ response property for the response status default

      response-property-enum-value-added

    • ●

      added the new login_service_unavailable enum value to the error/oneOf[subschema #2: StructuredError]/code response property for the response status 400

      response-property-enum-value-added

    • ●

      added the new login_service_unavailable enum value to the error/oneOf[subschema #2: StructuredError]/code response property for the response status 401

      response-property-enum-value-added

    • ●

      added the new login_service_unavailable enum value to the error/oneOf[subschema #2: StructuredError]/code response property for the response status 404

      response-property-enum-value-added

    • ●

      added the new login_service_unavailable enum value to the error/oneOf[subschema #2: StructuredError]/code response property for the response status default

      response-property-enum-value-added

    • ●

      added the new missing_url enum value to the allOf[Error]/error/oneOf[subschema #1: LegacyErrorCode]/ response property for the response status 429

      response-property-enum-value-added

    • ●

      added the new missing_url enum value to the allOf[Error]/error/oneOf[subschema #2: StructuredError]/code response property for the response status 429

      response-property-enum-value-added

    • ●

      added the new missing_url enum value to the error/oneOf[subschema #1: LegacyErrorCode]/ response property for the response status 400

      response-property-enum-value-added

    • ●

      added the new missing_url enum value to the error/oneOf[subschema #1: LegacyErrorCode]/ response property for the response status 401

      response-property-enum-value-added

    • ●

      added the new missing_url enum value to the error/oneOf[subschema #1: LegacyErrorCode]/ response property for the response status 404

      response-property-enum-value-added

    • ●

      added the new missing_url enum value to the error/oneOf[subschema #1: LegacyErrorCode]/ response property for the response status default

      response-property-enum-value-added

    • ●

      added the new missing_url enum value to the error/oneOf[subschema #2: StructuredError]/code response property for the response status 400

      response-property-enum-value-added

    • ●

      added the new missing_url enum value to the error/oneOf[subschema #2: StructuredError]/code response property for the response status 401

      response-property-enum-value-added

    • ●

      added the new missing_url enum value to the error/oneOf[subschema #2: StructuredError]/code response property for the response status 404

      response-property-enum-value-added

    • ●

      added the new missing_url enum value to the error/oneOf[subschema #2: StructuredError]/code response property for the response status default

      response-property-enum-value-added

    • ●

      added the new too_many_tweets enum value to the allOf[Error]/error/oneOf[subschema #1: LegacyErrorCode]/ response property for the response status 429

      response-property-enum-value-added

    • ●

      added the new too_many_tweets enum value to the allOf[Error]/error/oneOf[subschema #2: StructuredError]/code response property for the response status 429

      response-property-enum-value-added

    • ●

      added the new too_many_tweets enum value to the error/oneOf[subschema #1: LegacyErrorCode]/ response property for the response status 400

      response-property-enum-value-added

    • ●

      added the new too_many_tweets enum value to the error/oneOf[subschema #1: LegacyErrorCode]/ response property for the response status 401

      response-property-enum-value-added

    • ●

      added the new too_many_tweets enum value to the error/oneOf[subschema #1: LegacyErrorCode]/ response property for the response status 404

      response-property-enum-value-added

    • ●

      added the new too_many_tweets enum value to the error/oneOf[subschema #1: LegacyErrorCode]/ response property for the response status default

      response-property-enum-value-added

    • ●

      added the new too_many_tweets enum value to the error/oneOf[subschema #2: StructuredError]/code response property for the response status 400

      response-property-enum-value-added

    • ●

      added the new too_many_tweets enum value to the error/oneOf[subschema #2: StructuredError]/code response property for the response status 401

      response-property-enum-value-added

    • ●

      added the new too_many_tweets enum value to the error/oneOf[subschema #2: StructuredError]/code response property for the response status 404

      response-property-enum-value-added

    • ●

      added the new too_many_tweets enum value to the error/oneOf[subschema #2: StructuredError]/code response property for the response status default

      response-property-enum-value-added

  • 4da209b29df830See the full diff
    • ●

      added the new coverage_cursor_gone enum value to the allOf[Error]/error/oneOf[subschema #1: LegacyErrorCode]/ response property for the response status 429

      response-property-enum-value-added

    • ●

      added the new coverage_cursor_gone enum value to the allOf[Error]/error/oneOf[subschema #2: StructuredError]/code response property for the response status 429

      response-property-enum-value-added

    • ●

      added the new coverage_cursor_gone enum value to the error/oneOf[subschema #1: LegacyErrorCode]/ response property for the response status 400

      response-property-enum-value-added

    • ●

      added the new coverage_cursor_gone enum value to the error/oneOf[subschema #1: LegacyErrorCode]/ response property for the response status 401

      response-property-enum-value-added

    • ●

      added the new coverage_cursor_gone enum value to the error/oneOf[subschema #1: LegacyErrorCode]/ response property for the response status 404

      response-property-enum-value-added

    • ●

      added the new coverage_cursor_gone enum value to the error/oneOf[subschema #1: LegacyErrorCode]/ response property for the response status default

      response-property-enum-value-added

    • ●

      added the new coverage_cursor_gone enum value to the error/oneOf[subschema #2: StructuredError]/code response property for the response status 400

      response-property-enum-value-added

    • ●

      added the new coverage_cursor_gone enum value to the error/oneOf[subschema #2: StructuredError]/code response property for the response status 401

      response-property-enum-value-added

    • ●

      added the new coverage_cursor_gone enum value to the error/oneOf[subschema #2: StructuredError]/code response property for the response status 404

      response-property-enum-value-added

    • ●

      added the new coverage_cursor_gone enum value to the error/oneOf[subschema #2: StructuredError]/code response property for the response status default

      response-property-enum-value-added

    • ●

      added the new coverage_cursor_unavailable enum value to the allOf[Error]/error/oneOf[subschema #1: LegacyErrorCode]/ response property for the response status 429

      response-property-enum-value-added

    • ●

      added the new coverage_cursor_unavailable enum value to the allOf[Error]/error/oneOf[subschema #2: StructuredError]/code response property for the response status 429

      response-property-enum-value-added

    • ●

      added the new coverage_cursor_unavailable enum value to the error/oneOf[subschema #1: LegacyErrorCode]/ response property for the response status 400

      response-property-enum-value-added

    • ●

      added the new coverage_cursor_unavailable enum value to the error/oneOf[subschema #1: LegacyErrorCode]/ response property for the response status 401

      response-property-enum-value-added

    • ●

      added the new coverage_cursor_unavailable enum value to the error/oneOf[subschema #1: LegacyErrorCode]/ response property for the response status 404

      response-property-enum-value-added

    • ●

      added the new coverage_cursor_unavailable enum value to the error/oneOf[subschema #1: LegacyErrorCode]/ response property for the response status default

      response-property-enum-value-added

    • ●

      added the new coverage_cursor_unavailable enum value to the error/oneOf[subschema #2: StructuredError]/code response property for the response status 400

      response-property-enum-value-added

    • ●

      added the new coverage_cursor_unavailable enum value to the error/oneOf[subschema #2: StructuredError]/code response property for the response status 401

      response-property-enum-value-added

    • ●

      added the new coverage_cursor_unavailable enum value to the error/oneOf[subschema #2: StructuredError]/code response property for the response status 404

      response-property-enum-value-added

    • ●

      added the new coverage_cursor_unavailable enum value to the error/oneOf[subschema #2: StructuredError]/code response property for the response status default

      response-property-enum-value-added

    • ●

      added the new invalid_coverage_cursor enum value to the allOf[Error]/error/oneOf[subschema #1: LegacyErrorCode]/ response property for the response status 429

      response-property-enum-value-added

    • ●

      added the new invalid_coverage_cursor enum value to the allOf[Error]/error/oneOf[subschema #2: StructuredError]/code response property for the response status 429

      response-property-enum-value-added

    • ●

      added the new invalid_coverage_cursor enum value to the error/oneOf[subschema #1: LegacyErrorCode]/ response property for the response status 400

      response-property-enum-value-added

    • ●

      added the new invalid_coverage_cursor enum value to the error/oneOf[subschema #1: LegacyErrorCode]/ response property for the response status 401

      response-property-enum-value-added

    • ●

      added the new invalid_coverage_cursor enum value to the error/oneOf[subschema #1: LegacyErrorCode]/ response property for the response status 404

      response-property-enum-value-added

    • ●

      added the new invalid_coverage_cursor enum value to the error/oneOf[subschema #1: LegacyErrorCode]/ response property for the response status default

      response-property-enum-value-added

    • ●

      added the new invalid_coverage_cursor enum value to the error/oneOf[subschema #2: StructuredError]/code response property for the response status 400

      response-property-enum-value-added

    • ●

      added the new invalid_coverage_cursor enum value to the error/oneOf[subschema #2: StructuredError]/code response property for the response status 401

      response-property-enum-value-added

    • ●

      added the new invalid_coverage_cursor enum value to the error/oneOf[subschema #2: StructuredError]/code response property for the response status 404

      response-property-enum-value-added

    • ●

      added the new invalid_coverage_cursor enum value to the error/oneOf[subschema #2: StructuredError]/code response property for the response status default

      response-property-enum-value-added