> For the complete documentation index, see [llms.txt](https://docs.nyaru.xyz/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.nyaru.xyz/giveaways/glist.md).

# list

{% tabs %}
{% tab title="Aliases" %}
giveawaylist, gwlist
{% endtab %}

{% tab title="Cooldown" %}
30 seconds
{% endtab %}

{% tab title="Permissions" %}

* `MANAGE_SERVER:` The discord user running the command should have at least this permission in the giveaway server.
  {% endtab %}

{% tab title="Requirements" %}

* `VIEW_CHANNEL:` Nyaru should be able to view the giveaway channel.
* `SEND_MESSAGES:` Nyaru should be able to send the giveaway message.
* `EMBED_LINKS:` Nyaru should be able to send giveaway embeds in the giveaway channel.
  {% endtab %}
  {% endtabs %}

## Usage

`@Nyaru glist`

`/giveaway list`` `<mark style="color:purple;">`[Type]`</mark>

## Example

In the slash command, you have an optional property <mark style="color:purple;">Type</mark> that allows you to narrow down your giveaway list selection from all giveaways.

1. All: This is the default type selection, it shows you all giveaways on the server.
2. Running: This narrows the giveaway list to only running giveaways on the server.
3. Ended: This narrows the giveaway list to only ended giveaways on the server.

#### Scenario: You want to display only the running giveaways on the server:

> `/giveaway list`` `<mark style="color:purple;">`type: running`</mark>