--- title: "Search messages" method: POST path: "/search/messages" tags: ["Search"] --- # Search messages `POST /search/messages` Searches for messages across guilds and channels accessible to the authenticated user. Bots must supply a context guild or channel and may only use the current scope. ## Request body - GlobalSearchMessagesRequest - `hits_per_page` integer — Number of results per page (1-25) - `page` integer — Page number for pagination (ignored when cursor is provided) - `cursor` string[] — Opaque cursor for search_after pagination. When provided, page is ignored. - `max_id` string, snowflake - `min_id` string, snowflake - `content` string — Text content to search for - `contents` string[] — Multiple content queries to search for - `exact_phrases` string[] — Exact phrases that must appear contiguously in message content - `channel_id` SnowflakeType[] — Channel IDs to search in - `exclude_channel_id` SnowflakeType[] — Channel IDs to exclude from search - `author_type` string[] — Author types to filter by - `exclude_author_type` string[] — Author types to exclude - `author_id` SnowflakeType[] — Author user IDs to filter by - `exclude_author_id` SnowflakeType[] — Author user IDs to exclude - `mentions` SnowflakeType[] — User IDs that must be mentioned - `exclude_mentions` SnowflakeType[] — User IDs that must not be mentioned - `mention_everyone` boolean — Filter by whether message mentions everyone - `pinned` boolean — Filter by pinned status - `has` string[] — Content flags the message must have. Use image, video, sound, or file for uploaded attachments and embed for link previews or rich embeds. - `exclude_has` string[] — Content flags the message must not have. Use image, video, sound, or file for uploaded attachments and embed for link previews or rich embeds. - `embed_type` string[] — Generated or supplied embed types to filter by; does not match uploaded attachments - `exclude_embed_type` string[] — Generated or supplied embed types to exclude; does not match uploaded attachments - `embed_provider` string[] — Embed providers to filter by - `exclude_embed_provider` string[] — Embed providers to exclude - `link_hostname` string[] — Link hostnames to filter by - `exclude_link_hostname` string[] — Link hostnames to exclude - `attachment_filename` string[] — Attachment filenames to filter by - `exclude_attachment_filename` string[] — Attachment filenames to exclude - `attachment_extension` string[] — File extensions to filter by - `exclude_attachment_extension` string[] — File extensions to exclude - `sort_by` 'timestamp' | 'relevance' — Field to sort results by - `sort_order` 'asc' | 'desc' — Sort order for results - `include_nsfw` boolean — Whether to include NSFW channel results - `scope` 'current' | 'open_dms' | 'all_dms' | 'all_guilds' | 'all' | 'open_dms_and_all_guilds' — Scope to search within when querying messages - `context_channel_id` string, snowflake - `context_guild_id` string, snowflake - `channel_ids` SnowflakeType[] — Specific channel IDs to search in ## Response `200` Success - union - MessageSearchResultsResponse - `messages` object[], required — The messages matching the search query - `id` string, required — The unique identifier (snowflake) for this message - `channel_id` string, required — The ID of the channel this message was sent in - `author` UserPartialResponse, required - `id` string, required — The unique identifier (snowflake) for this user - `username` string, required — The username of the user, not unique across the platform - `discriminator` string, required — The four-digit discriminator tag of the user - `global_name` string, nullable, required — The display name of the user, if set - `avatar` string, nullable, required — The hash of the user avatar image - `avatar_color` integer, required - `bot` boolean — Whether the user is a bot account - `system` boolean — Whether the user is an official system user - `flags` integer, required — The public flags on the user account - `mention_flags` 0 | 1 | 2 — Reply mention preference - `webhook_id` string, snowflake - `type` 0 | 1 | 2 | 3 | 4 | 5 | 6 | 7 | 19, required — The type of message - `flags` integer, required — Message flags bitfield - `content` string, required — The text content of the message - `timestamp` string, date-time, required — The ISO 8601 timestamp of when the message was created - `edited_timestamp` string, date-time, nullable — The ISO 8601 timestamp of when the message was last edited - `pinned` boolean, required — Whether the message is pinned - `mention_everyone` boolean, required — Whether the message mentions @everyone - `tts` boolean, required — Whether the message was sent as text-to-speech - `mentions` UserPartialResponse[], required — The users mentioned in the message - `id` string, required — The unique identifier (snowflake) for this user - `username` string, required — The username of the user, not unique across the platform - `discriminator` string, required — The four-digit discriminator tag of the user - `global_name` string, nullable, required — The display name of the user, if set - `avatar` string, nullable, required — The hash of the user avatar image - `avatar_color` integer, required - `bot` boolean — Whether the user is a bot account - `system` boolean — Whether the user is an official system user - `flags` integer, required — The public flags on the user account - `mention_flags` 0 | 1 | 2 — Reply mention preference - `mention_roles` string[], required — The role IDs mentioned in the message - `mention_channels` MessageChannelMentionResponse[], nullable — Channels mentioned in the message that are visible to @everyone - `id` string, required — The ID of the mentioned channel - `name` string, required — The name of the mentioned channel - `type` integer, required — The type of the mentioned channel - `users` UserPartialResponse[], nullable — Users referenced from non-notifying content, embed, and snapshot text, included for client-side resolution - `id` string, required — The unique identifier (snowflake) for this user - `username` string, required — The username of the user, not unique across the platform - `discriminator` string, required — The four-digit discriminator tag of the user - `global_name` string, nullable, required — The display name of the user, if set - `avatar` string, nullable, required — The hash of the user avatar image - `avatar_color` integer, required - `bot` boolean — Whether the user is a bot account - `system` boolean — Whether the user is an official system user - `flags` integer, required — The public flags on the user account - `mention_flags` 0 | 1 | 2 — Reply mention preference - `embeds` MessageEmbedResponse[], nullable — The embeds attached to the message - `type` string, required — The type of embed (e.g., rich, image, video, gifv, article, link) - `url` string, uri, nullable — The URL of the embed - `title` string, nullable — The title of the embed - `color` integer - `timestamp` string, date-time, nullable — The ISO 8601 timestamp of the embed content - `description` string, nullable — The description of the embed - `author` EmbedAuthorResponse - `name` string, required — The name of the author - `url` string, uri, nullable — The URL of the author - `icon_url` string, uri, nullable — The URL of the author icon - `proxy_icon_url` string, uri, nullable — The proxied URL of the author icon - `image` EmbedMediaResponse - `url` string, required — The URL of the media - `proxy_url` string, uri, nullable — The proxied URL of the media - `content_type` string, nullable — The MIME type of the media - `content_hash` string, nullable — The hash of the media content - `width` integer - `height` integer - `description` string, nullable — The description of the media - `placeholder` string, nullable — The base64 encoded placeholder image for lazy loading - `duration` integer - `flags` integer, required — The bitwise flags for this media - `thumbnail` EmbedMediaResponse - `url` string, required — The URL of the media - `proxy_url` string, uri, nullable — The proxied URL of the media - `content_type` string, nullable — The MIME type of the media - `content_hash` string, nullable — The hash of the media content - `width` integer - `height` integer - `description` string, nullable — The description of the media - `placeholder` string, nullable — The base64 encoded placeholder image for lazy loading - `duration` integer - `flags` integer, required — The bitwise flags for this media - `footer` EmbedFooterResponse - `text` string, required — The footer text - `icon_url` string, uri, nullable — The URL of the footer icon - `proxy_icon_url` string, uri, nullable — The proxied URL of the footer icon - `fields` EmbedFieldResponse[], nullable — The fields of the embed - `name` string, required — The name of the field - `value` string, required — The value of the field - `inline` boolean, required — Whether the field should be displayed inline - `provider` EmbedAuthorResponse - `name` string, required — The name of the author - `url` string, uri, nullable — The URL of the author - `icon_url` string, uri, nullable — The URL of the author icon - `proxy_icon_url` string, uri, nullable — The proxied URL of the author icon - `video` EmbedMediaResponse - `url` string, required — The URL of the media - `proxy_url` string, uri, nullable — The proxied URL of the media - `content_type` string, nullable — The MIME type of the media - `content_hash` string, nullable — The hash of the media content - `width` integer - `height` integer - `description` string, nullable — The description of the media - `placeholder` string, nullable — The base64 encoded placeholder image for lazy loading - `duration` integer - `flags` integer, required — The bitwise flags for this media - `audio` EmbedMediaResponse - `url` string, required — The URL of the media - `proxy_url` string, uri, nullable — The proxied URL of the media - `content_type` string, nullable — The MIME type of the media - `content_hash` string, nullable — The hash of the media content - `width` integer - `height` integer - `description` string, nullable — The description of the media - `placeholder` string, nullable — The base64 encoded placeholder image for lazy loading - `duration` integer - `flags` integer, required — The bitwise flags for this media - `html` string, nullable — Sanitized oEmbed HTML for trusted specialized embed renderers - `html_width` integer - `html_height` integer - `nsfw` boolean, nullable — Whether the embed is flagged as NSFW - `children` MessageEmbedChildResponse[], nullable — Internal nested embeds generated by unfurlers - `type` string, required — The type of embed (e.g., rich, image, video, gifv, article, link) - `url` string, uri, nullable — The URL of the embed - `title` string, nullable — The title of the embed - `color` integer - `timestamp` string, date-time, nullable — The ISO 8601 timestamp of the embed content - `description` string, nullable — The description of the embed - `author` EmbedAuthorResponse - `name` string, required — The name of the author - `url` string, uri, nullable — The URL of the author - `icon_url` string, uri, nullable — The URL of the author icon - `proxy_icon_url` string, uri, nullable — The proxied URL of the author icon - `image` EmbedMediaResponse - `url` string, required — The URL of the media - `proxy_url` string, uri, nullable — The proxied URL of the media - `content_type` string, nullable — The MIME type of the media - `content_hash` string, nullable — The hash of the media content - `width` integer - `height` integer - `description` string, nullable — The description of the media - `placeholder` string, nullable — The base64 encoded placeholder image for lazy loading - `duration` integer - `flags` integer, required — The bitwise flags for this media - `thumbnail` EmbedMediaResponse - `url` string, required — The URL of the media - `proxy_url` string, uri, nullable — The proxied URL of the media - `content_type` string, nullable — The MIME type of the media - `content_hash` string, nullable — The hash of the media content - `width` integer - `height` integer - `description` string, nullable — The description of the media - `placeholder` string, nullable — The base64 encoded placeholder image for lazy loading - `duration` integer - `flags` integer, required — The bitwise flags for this media - `footer` EmbedFooterResponse - `text` string, required — The footer text - `icon_url` string, uri, nullable — The URL of the footer icon - `proxy_icon_url` string, uri, nullable — The proxied URL of the footer icon - `fields` EmbedFieldResponse[], nullable — The fields of the embed - `name` string, required — The name of the field - `value` string, required — The value of the field - `inline` boolean, required — Whether the field should be displayed inline - `provider` EmbedAuthorResponse - `name` string, required — The name of the author - `url` string, uri, nullable — The URL of the author - `icon_url` string, uri, nullable — The URL of the author icon - `proxy_icon_url` string, uri, nullable — The proxied URL of the author icon - `video` EmbedMediaResponse - `url` string, required — The URL of the media - `proxy_url` string, uri, nullable — The proxied URL of the media - `content_type` string, nullable — The MIME type of the media - `content_hash` string, nullable — The hash of the media content - `width` integer - `height` integer - `description` string, nullable — The description of the media - `placeholder` string, nullable — The base64 encoded placeholder image for lazy loading - `duration` integer - `flags` integer, required — The bitwise flags for this media - `audio` EmbedMediaResponse - `url` string, required — The URL of the media - `proxy_url` string, uri, nullable — The proxied URL of the media - `content_type` string, nullable — The MIME type of the media - `content_hash` string, nullable — The hash of the media content - `width` integer - `height` integer - `description` string, nullable — The description of the media - `placeholder` string, nullable — The base64 encoded placeholder image for lazy loading - `duration` integer - `flags` integer, required — The bitwise flags for this media - `html` string, nullable — Sanitized oEmbed HTML for trusted specialized embed renderers - `html_width` integer - `html_height` integer - `nsfw` boolean, nullable — Whether the embed is flagged as NSFW - `attachments` MessageAttachmentResponse[], nullable — The files attached to the message - `id` string, required — The unique identifier for this attachment - `filename` string, required — The name of the attached file - `title` string, nullable — The title of the attachment - `description` string, nullable — The description of the attachment - `content_type` string, nullable — The MIME type of the attachment - `content_hash` string, nullable — The hash of the attachment content - `size` integer, required — The size of the attachment in bytes - `url` string, nullable — The URL of the attachment - `proxy_url` string, nullable — The proxied URL of the attachment - `width` integer - `height` integer - `placeholder` string, nullable — The base64 encoded placeholder image for lazy loading - `flags` integer, required — Attachment flags - `nsfw` boolean, nullable — Whether the attachment is flagged as NSFW - `duration` integer - `waveform` string, nullable — The base64 encoded audio waveform data - `expires_at` string, nullable — The ISO 8601 timestamp when the attachment URL expires - `expired` boolean, nullable — Whether the attachment URL has expired - `stickers` MessageStickerResponse[], nullable — The stickers sent with the message - `id` string, required — The unique identifier of the sticker - `name` string, required — The name of the sticker - `animated` boolean, required — Whether the sticker is animated - `nsfw` boolean — Whether this sticker is classified as NSFW - `nsfw_emojis` SnowflakeType[] — IDs of custom emojis in this message that are classified as NSFW - `reactions` MessageReactionResponse[], nullable — The reactions on the message - `emoji` object, required — The emoji used for the reaction - `id` string, snowflake - `name` string, required — The name of the emoji (or Unicode character for standard emojis) - `animated` boolean, nullable — Whether the emoji is animated - `count` integer, required — The total number of times this reaction has been used - `me` boolean, nullable — Whether the current user has reacted with this emoji - `message_reference` object, nullable — Reference data for replies or forwards - `channel_id` string, required — The ID of the channel containing the referenced message - `message_id` string, required — The ID of the referenced message - `guild_id` string, snowflake - `type` 0 | 1, required — The type of message reference - `message_snapshots` MessageSnapshotResponse[], nullable — Snapshots of forwarded messages - `content` string, nullable — The text content of the snapshot - `timestamp` string, date-time, required — The ISO 8601 timestamp of when the original message was created - `edited_timestamp` string, date-time, nullable — The ISO 8601 timestamp of when the original message was last edited - `mentions` string[], nullable — The user IDs mentioned in the snapshot - `mention_roles` string[], nullable — The role IDs mentioned in the snapshot - `mention_channels` MessageChannelMentionResponse[], nullable — Channels mentioned in the snapshot that are visible to @everyone - `id` string, required — The ID of the mentioned channel - `name` string, required — The name of the mentioned channel - `type` integer, required — The type of the mentioned channel - `embeds` MessageEmbedResponse[], nullable — The embeds included in the snapshot - `type` string, required — The type of embed (e.g., rich, image, video, gifv, article, link) - `url` string, uri, nullable — The URL of the embed - `title` string, nullable — The title of the embed - `color` integer - `timestamp` string, date-time, nullable — The ISO 8601 timestamp of the embed content - `description` string, nullable — The description of the embed - `author` EmbedAuthorResponse - `name` string, required — The name of the author - `url` string, uri, nullable — The URL of the author - `icon_url` string, uri, nullable — The URL of the author icon - `proxy_icon_url` string, uri, nullable — The proxied URL of the author icon - `image` EmbedMediaResponse - `url` string, required — The URL of the media - `proxy_url` string, uri, nullable — The proxied URL of the media - `content_type` string, nullable — The MIME type of the media - `content_hash` string, nullable — The hash of the media content - `width` integer - `height` integer - `description` string, nullable — The description of the media - `placeholder` string, nullable — The base64 encoded placeholder image for lazy loading - `duration` integer - `flags` integer, required — The bitwise flags for this media - `thumbnail` EmbedMediaResponse - `url` string, required — The URL of the media - `proxy_url` string, uri, nullable — The proxied URL of the media - `content_type` string, nullable — The MIME type of the media - `content_hash` string, nullable — The hash of the media content - `width` integer - `height` integer - `description` string, nullable — The description of the media - `placeholder` string, nullable — The base64 encoded placeholder image for lazy loading - `duration` integer - `flags` integer, required — The bitwise flags for this media - `footer` EmbedFooterResponse - `text` string, required — The footer text - `icon_url` string, uri, nullable — The URL of the footer icon - `proxy_icon_url` string, uri, nullable — The proxied URL of the footer icon - `fields` EmbedFieldResponse[], nullable — The fields of the embed - `name` string, required — The name of the field - `value` string, required — The value of the field - `inline` boolean, required — Whether the field should be displayed inline - `provider` EmbedAuthorResponse - `name` string, required — The name of the author - `url` string, uri, nullable — The URL of the author - `icon_url` string, uri, nullable — The URL of the author icon - `proxy_icon_url` string, uri, nullable — The proxied URL of the author icon - `video` EmbedMediaResponse - `url` string, required — The URL of the media - `proxy_url` string, uri, nullable — The proxied URL of the media - `content_type` string, nullable — The MIME type of the media - `content_hash` string, nullable — The hash of the media content - `width` integer - `height` integer - `description` string, nullable — The description of the media - `placeholder` string, nullable — The base64 encoded placeholder image for lazy loading - `duration` integer - `flags` integer, required — The bitwise flags for this media - `audio` EmbedMediaResponse - `url` string, required — The URL of the media - `proxy_url` string, uri, nullable — The proxied URL of the media - `content_type` string, nullable — The MIME type of the media - `content_hash` string, nullable — The hash of the media content - `width` integer - `height` integer - `description` string, nullable — The description of the media - `placeholder` string, nullable — The base64 encoded placeholder image for lazy loading - `duration` integer - `flags` integer, required — The bitwise flags for this media - `html` string, nullable — Sanitized oEmbed HTML for trusted specialized embed renderers - `html_width` integer - `html_height` integer - `nsfw` boolean, nullable — Whether the embed is flagged as NSFW - `children` MessageEmbedChildResponse[], nullable — Internal nested embeds generated by unfurlers - `type` string, required — The type of embed (e.g., rich, image, video, gifv, article, link) - `url` string, uri, nullable — The URL of the embed - `title` string, nullable — The title of the embed - `color` integer - `timestamp` string, date-time, nullable — The ISO 8601 timestamp of the embed content - `description` string, nullable — The description of the embed - `author` EmbedAuthorResponse - … - `image` EmbedMediaResponse - … - `thumbnail` EmbedMediaResponse - … - `footer` EmbedFooterResponse - … - `fields` EmbedFieldResponse[], nullable — The fields of the embed - … - `provider` EmbedAuthorResponse - … - `video` EmbedMediaResponse - … - `audio` EmbedMediaResponse - … - `html` string, nullable — Sanitized oEmbed HTML for trusted specialized embed renderers - `html_width` integer - `html_height` integer - `nsfw` boolean, nullable — Whether the embed is flagged as NSFW - `attachments` MessageAttachmentResponse[], nullable — The attachments included in the snapshot - `id` string, required — The unique identifier for this attachment - `filename` string, required — The name of the attached file - `title` string, nullable — The title of the attachment - `description` string, nullable — The description of the attachment - `content_type` string, nullable — The MIME type of the attachment - `content_hash` string, nullable — The hash of the attachment content - `size` integer, required — The size of the attachment in bytes - `url` string, nullable — The URL of the attachment - `proxy_url` string, nullable — The proxied URL of the attachment - `width` integer - `height` integer - `placeholder` string, nullable — The base64 encoded placeholder image for lazy loading - `flags` integer, required — Attachment flags - `nsfw` boolean, nullable — Whether the attachment is flagged as NSFW - `duration` integer - `waveform` string, nullable — The base64 encoded audio waveform data - `expires_at` string, nullable — The ISO 8601 timestamp when the attachment URL expires - `expired` boolean, nullable — Whether the attachment URL has expired - `stickers` MessageStickerResponse[], nullable — The stickers included in the snapshot - `id` string, required — The unique identifier of the sticker - `name` string, required — The name of the sticker - `animated` boolean, required — Whether the sticker is animated - `nsfw` boolean — Whether this sticker is classified as NSFW - `type` 0 | 1 | 2 | 3 | 4 | 5 | 6 | 7 | 19, required — The type of message - `flags` integer, required — Message flags bitfield - `nonce` string, nullable — A client-provided value for message deduplication - `call` object, nullable — Call information if this message represents a call - `participants` string[], required — The user IDs of participants in the call - `ended_timestamp` string, date-time, nullable — The ISO 8601 timestamp of when the call ended - `channels` ChannelResponse[], required — Serialized channels referenced by the returned messages - `id` string, required — The unique identifier (snowflake) for this channel - `guild_id` string, snowflake - `name` string — The name of the channel - `topic` string, nullable — The topic of the channel - `url` string, uri, nullable — The URL associated with the channel - `icon` string, nullable — The icon hash of the channel (for group DMs) - `owner_id` string, snowflake - `type` integer, required — The type of the channel - `position` integer - `parent_id` string, snowflake - `bitrate` integer - `user_limit` integer - `voice_connection_limit` integer - `rtc_region` string, nullable — The voice region ID for the voice channel - `last_message_id` string, snowflake - `last_pin_timestamp` string, date-time, nullable — The ISO 8601 timestamp of when the last pinned message was pinned - `permission_overwrites` ChannelOverwriteResponse[] — The permission overwrites for this channel - `id` string, required — The unique identifier for the role or user this overwrite applies to - `type` 0 | 1, required — The type of entity the overwrite applies to - `allow` string, int64, required — The bitwise value of allowed permissions - `deny` string, int64, required — The bitwise value of denied permissions - `recipients` UserPartialResponse[] — The recipients of the DM channel - `id` string, required — The unique identifier (snowflake) for this user - `username` string, required — The username of the user, not unique across the platform - `discriminator` string, required — The four-digit discriminator tag of the user - `global_name` string, nullable, required — The display name of the user, if set - `avatar` string, nullable, required — The hash of the user avatar image - `avatar_color` integer, required - `bot` boolean — Whether the user is a bot account - `system` boolean — Whether the user is an official system user - `flags` integer, required — The public flags on the user account - `mention_flags` 0 | 1 | 2 — Reply mention preference - `nsfw` boolean — Whether the channel is marked as NSFW (effective value, walking channel → category → guild) - `nsfw_override` boolean, nullable — Per-channel adult-content override; null means inherit from parent category and then guild. Categories use this same field as their own override. - `content_warning_level` 0 | 1 — The content warning level for a guild, category, or channel - `content_warning_text` string, nullable — Custom channel content warning text (max 200 characters); null inherits from parent or guild - `rate_limit_per_user` integer - `nicks` object — Custom nicknames for users in this channel (for group DMs) - `total` integer, required — The total number of messages matching the search - `hits_per_page` integer, required — The maximum number of messages returned per page - `page` integer, required — The current page number - `cursor` string[] — Opaque cursor for fetching the next page of results - object - `indexing` true, required — Indicates that one or more channels are being indexed ## Other responses - `400` — Bad Request - The request was malformed or contained invalid data - `401` — Unauthorized - Authentication is required or the token is invalid - `403` — Forbidden - You do not have permission to perform this action - `429` — Too Many Requests - You are being rate limited - `500` — Internal Server Error - An unexpected error occurred --- [API](https://skmtc.dev/fluxer/apis/fluxer-api.md) · [All operations](https://skmtc.dev/fluxer/apis/fluxer-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/fluxer/fluxer-api/revisions/d9c706133cc5/schema)