--- title: "GET /applications/{application_id}/commands" method: GET path: "/applications/{application_id}/commands" --- # GET /applications/{application_id}/commands `GET /applications/{application_id}/commands` ## Query parameters - `with_localizations` boolean ## Response `200` 200 response for list_application_commands - ApplicationCommandResponse[], nullable - `id` string, snowflake, required - `application_id` string, snowflake, required - `version` string, snowflake, required - `default_member_permissions` string, nullable, required - `type` union, required - 1 — Slash commands; a text-based command that shows up when a user types / - 2 — A UI-based command that shows up when you right click or tap on a user - 3 — A UI-based command that shows up when you right click or tap on a message - 4 — A command that represents the primary way to use an application (e.g. launching an Activity) - `name` string, required - `name_localized` string - `name_localizations` object, nullable - `description` string, required - `description_localized` string - `description_localizations` object, nullable - `guild_id` string, snowflake - `dm_permission` boolean - `contexts` InteractionContextType[], nullable - union - 0 — This command can be used within a Guild. - 1 — This command can be used within a DM with this application's bot. - 2 — This command can be used within DMs and Group DMs with users. - `integration_types` ApplicationIntegrationType[] - union - 0 — For Guild install. - 1 — For User install. - `options` union[] - union - ApplicationCommandAttachmentOptionResponse - `type` union, required - 1 — A sub-action within a command or group - 2 — A group of subcommands - 3 — A string option - 4 — An integer option. Any integer between -2^53 and 2^53 is a valid value - 5 — A boolean option - 6 — A snowflake option that represents a User - 7 — A snowflake option that represents a Channel. Includes all channel types and categories - 8 — A snowflake option that represents a Role - 9 — A snowflake option that represents anything you can mention - 10 — A number option. Any double between -2^53 and 2^53 is a valid value - 11 — An attachment option - `name` string, required - `name_localized` string - `name_localizations` object, nullable - `description` string, required - `description_localized` string - `description_localizations` object, nullable - `required` boolean - `file_types` string[] - ApplicationCommandBooleanOptionResponse - `type` union, required - 1 — A sub-action within a command or group - 2 — A group of subcommands - 3 — A string option - 4 — An integer option. Any integer between -2^53 and 2^53 is a valid value - 5 — A boolean option - 6 — A snowflake option that represents a User - 7 — A snowflake option that represents a Channel. Includes all channel types and categories - 8 — A snowflake option that represents a Role - 9 — A snowflake option that represents anything you can mention - 10 — A number option. Any double between -2^53 and 2^53 is a valid value - 11 — An attachment option - `name` string, required - `name_localized` string - `name_localizations` object, nullable - `description` string, required - `description_localized` string - `description_localizations` object, nullable - `required` boolean - ApplicationCommandChannelOptionResponse - `type` union, required - 1 — A sub-action within a command or group - 2 — A group of subcommands - 3 — A string option - 4 — An integer option. Any integer between -2^53 and 2^53 is a valid value - 5 — A boolean option - 6 — A snowflake option that represents a User - 7 — A snowflake option that represents a Channel. Includes all channel types and categories - 8 — A snowflake option that represents a Role - 9 — A snowflake option that represents anything you can mention - 10 — A number option. Any double between -2^53 and 2^53 is a valid value - 11 — An attachment option - `name` string, required - `name_localized` string - `name_localizations` object, nullable - `description` string, required - `description_localized` string - `description_localizations` object, nullable - `required` boolean - `channel_types` ChannelTypes[] - union - 1 — A direct message between users - 3 — A direct message between multiple users - 0 — A text channel within a server - 2 — A voice channel within a server - 4 — An organizational category that contains up to 50 channels - 5 — A channel that users can follow and crosspost into their own server (formerly news channels) - 10 — A temporary sub-channel within a GUILD_ANNOUNCEMENT channel - 11 — A temporary sub-channel within a GUILD_TEXT or GUILD_THREADS_ONLY channel type set - 12 — A temporary sub-channel within a GUILD_TEXT channel that is only viewable by those invited and those with the MANAGE_THREADS permission - 13 — A voice channel for hosting events with an audience - 14 — The channel in a hub containing the listed servers - 15 — Channel that can only contain threads - ApplicationCommandIntegerOptionResponse - `type` union, required - 1 — A sub-action within a command or group - 2 — A group of subcommands - 3 — A string option - 4 — An integer option. Any integer between -2^53 and 2^53 is a valid value - 5 — A boolean option - 6 — A snowflake option that represents a User - 7 — A snowflake option that represents a Channel. Includes all channel types and categories - 8 — A snowflake option that represents a Role - 9 — A snowflake option that represents anything you can mention - 10 — A number option. Any double between -2^53 and 2^53 is a valid value - 11 — An attachment option - `name` string, required - `name_localized` string - `name_localizations` object, nullable - `description` string, required - `description_localized` string - `description_localizations` object, nullable - `required` boolean - `autocomplete` boolean - `choices` ApplicationCommandOptionIntegerChoiceResponse[] - `name` string, required - `name_localized` string - `name_localizations` object, nullable - `value` integer, required - `min_value` integer - `max_value` integer - ApplicationCommandMentionableOptionResponse - `type` union, required - 1 — A sub-action within a command or group - 2 — A group of subcommands - 3 — A string option - 4 — An integer option. Any integer between -2^53 and 2^53 is a valid value - 5 — A boolean option - 6 — A snowflake option that represents a User - 7 — A snowflake option that represents a Channel. Includes all channel types and categories - 8 — A snowflake option that represents a Role - 9 — A snowflake option that represents anything you can mention - 10 — A number option. Any double between -2^53 and 2^53 is a valid value - 11 — An attachment option - `name` string, required - `name_localized` string - `name_localizations` object, nullable - `description` string, required - `description_localized` string - `description_localizations` object, nullable - `required` boolean - ApplicationCommandNumberOptionResponse - `type` union, required - 1 — A sub-action within a command or group - 2 — A group of subcommands - 3 — A string option - 4 — An integer option. Any integer between -2^53 and 2^53 is a valid value - 5 — A boolean option - 6 — A snowflake option that represents a User - 7 — A snowflake option that represents a Channel. Includes all channel types and categories - 8 — A snowflake option that represents a Role - 9 — A snowflake option that represents anything you can mention - 10 — A number option. Any double between -2^53 and 2^53 is a valid value - 11 — An attachment option - `name` string, required - `name_localized` string - `name_localizations` object, nullable - `description` string, required - `description_localized` string - `description_localizations` object, nullable - `required` boolean - `autocomplete` boolean - `choices` ApplicationCommandOptionNumberChoiceResponse[] - `name` string, required - `name_localized` string - `name_localizations` object, nullable - `value` number, double, required - `min_value` number, double - `max_value` number, double - ApplicationCommandRoleOptionResponse - `type` union, required - 1 — A sub-action within a command or group - 2 — A group of subcommands - 3 — A string option - 4 — An integer option. Any integer between -2^53 and 2^53 is a valid value - 5 — A boolean option - 6 — A snowflake option that represents a User - 7 — A snowflake option that represents a Channel. Includes all channel types and categories - 8 — A snowflake option that represents a Role - 9 — A snowflake option that represents anything you can mention - 10 — A number option. Any double between -2^53 and 2^53 is a valid value - 11 — An attachment option - `name` string, required - `name_localized` string - `name_localizations` object, nullable - `description` string, required - `description_localized` string - `description_localizations` object, nullable - `required` boolean - ApplicationCommandStringOptionResponse - `type` union, required - 1 — A sub-action within a command or group - 2 — A group of subcommands - 3 — A string option - 4 — An integer option. Any integer between -2^53 and 2^53 is a valid value - 5 — A boolean option - 6 — A snowflake option that represents a User - 7 — A snowflake option that represents a Channel. Includes all channel types and categories - 8 — A snowflake option that represents a Role - 9 — A snowflake option that represents anything you can mention - 10 — A number option. Any double between -2^53 and 2^53 is a valid value - 11 — An attachment option - `name` string, required - `name_localized` string - `name_localizations` object, nullable - `description` string, required - `description_localized` string - `description_localizations` object, nullable - `required` boolean - `autocomplete` boolean - `choices` ApplicationCommandOptionStringChoiceResponse[] - `name` string, required - `name_localized` string - `name_localizations` object, nullable - `value` string, required - `min_length` integer - `max_length` integer - ApplicationCommandSubcommandGroupOptionResponse - `type` union, required - 1 — A sub-action within a command or group - 2 — A group of subcommands - 3 — A string option - 4 — An integer option. Any integer between -2^53 and 2^53 is a valid value - 5 — A boolean option - 6 — A snowflake option that represents a User - 7 — A snowflake option that represents a Channel. Includes all channel types and categories - 8 — A snowflake option that represents a Role - 9 — A snowflake option that represents anything you can mention - 10 — A number option. Any double between -2^53 and 2^53 is a valid value - 11 — An attachment option - `name` string, required - `name_localized` string - `name_localizations` object, nullable - `description` string, required - `description_localized` string - `description_localizations` object, nullable - `required` boolean - `options` ApplicationCommandSubcommandOptionResponse[] - `type` union, required - 1 — A sub-action within a command or group - 2 — A group of subcommands - 3 — A string option - 4 — An integer option. Any integer between -2^53 and 2^53 is a valid value - 5 — A boolean option - 6 — A snowflake option that represents a User - 7 — A snowflake option that represents a Channel. Includes all channel types and categories - 8 — A snowflake option that represents a Role - 9 — A snowflake option that represents anything you can mention - 10 — A number option. Any double between -2^53 and 2^53 is a valid value - 11 — An attachment option - `name` string, required - `name_localized` string - `name_localizations` object, nullable - `description` string, required - `description_localized` string - `description_localizations` object, nullable - `required` boolean - `options` union[] - union - … - ApplicationCommandSubcommandOptionResponse - `type` union, required - 1 — A sub-action within a command or group - 2 — A group of subcommands - 3 — A string option - 4 — An integer option. Any integer between -2^53 and 2^53 is a valid value - 5 — A boolean option - 6 — A snowflake option that represents a User - 7 — A snowflake option that represents a Channel. Includes all channel types and categories - 8 — A snowflake option that represents a Role - 9 — A snowflake option that represents anything you can mention - 10 — A number option. Any double between -2^53 and 2^53 is a valid value - 11 — An attachment option - `name` string, required - `name_localized` string - `name_localizations` object, nullable - `description` string, required - `description_localized` string - `description_localizations` object, nullable - `required` boolean - `options` union[] - union - ApplicationCommandAttachmentOptionResponse - … - ApplicationCommandBooleanOptionResponse - … - ApplicationCommandChannelOptionResponse - … - ApplicationCommandIntegerOptionResponse - … - ApplicationCommandMentionableOptionResponse - … - ApplicationCommandNumberOptionResponse - … - ApplicationCommandRoleOptionResponse - … - ApplicationCommandStringOptionResponse - … - ApplicationCommandUserOptionResponse - … - ApplicationCommandUserOptionResponse - `type` union, required - 1 — A sub-action within a command or group - 2 — A group of subcommands - 3 — A string option - 4 — An integer option. Any integer between -2^53 and 2^53 is a valid value - 5 — A boolean option - 6 — A snowflake option that represents a User - 7 — A snowflake option that represents a Channel. Includes all channel types and categories - 8 — A snowflake option that represents a Role - 9 — A snowflake option that represents anything you can mention - 10 — A number option. Any double between -2^53 and 2^53 is a valid value - 11 — An attachment option - `name` string, required - `name_localized` string - `name_localizations` object, nullable - `description` string, required - `description_localized` string - `description_localizations` object, nullable - `required` boolean - `nsfw` boolean - `handler` union - 1 — The app handles the interaction using an interaction token - 2 — Discord handles the interaction by launching an Activity and sending a follow-up message without coordinating with the app ## Other responses - `429` — Client ratelimited response - `4XX` — Client error response ## Changes - **2026-08-06** `f6cd197cbe47` — 3 info - added the optional property `items/options/items/oneOf[#/components/schemas/ApplicationCommandAttachmentOptionResponse]/file_types` to the response with the `200` status - added the optional property `items/options/items/oneOf[#/components/schemas/ApplicationCommandSubcommandGroupOptionResponse]/options/items/options/items/oneOf[#/components/schemas/ApplicationCommandAttachmentOptionResponse]/file_types` to the response with the `200` status - added the optional property `items/options/items/oneOf[#/components/schemas/ApplicationCommandSubcommandOptionResponse]/options/items/oneOf[#/components/schemas/ApplicationCommandAttachmentOptionResponse]/file_types` to the response with the `200` status - **2026-06-05** `693bf1f99bba` — 1 info - added the optional property `items/handler` to the response with the `200` status - **2026-02-04** `e200830e509a` — 1 info - the response property `items/default_member_permissions` became required for the status `200` [Change history](https://skmtc.dev/discord/apis/discord-http-api-preview/changes/applications/:application_id/commands/get.md) --- [API](https://skmtc.dev/discord/apis/discord-http-api-preview.md) · [All operations](https://skmtc.dev/discord/apis/discord-http-api-preview/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/discord/discord-http-api-preview/revisions/49efa428e0dd/schema)