# Claimtime

## What is claimtime ?

> Whenever you host a giveaway using apollo, each user is given a set "claimtime" i.e the time that they have to claim the "set prize". Using apollo's advanced claimtime manager helps you to give extra claim time to set users/roles. In this section we will go through the details of the claimtime.
>
> Please refer to the [**overrides**](/guides/overrides.md) section if you are not familiar with it as claimtime uses overrides.

## Subcommands for the Claimtime Module

### `a!claimtime`

> This command checks the claimtime for a user or a role. It gives the claimtime for a role and it gives the total claimtime for a user.

<figure><img src="/files/GvWQP98J6l1c8INfOcqm" alt=""><figcaption><p>claimtime for a member</p></figcaption></figure>

<figure><img src="/files/V7U9zpCSnTBs25Mtx3zq" alt=""><figcaption><p>claimtime for a specific role</p></figcaption></figure>

### Admin commands for the Claimtime Module

### `a!claimtime-admin add` (`/claimtime-admin add`)

> This command adds or updates a specific amount of time (claimtime) to the role mentioned. Use `s` for seconds, `m` for minutes and `h` for hours.

{% hint style="warning" %}
This only works for roles and cannot be set for specific users
{% endhint %}

<figure><img src="/files/uJYQasZM0OgcXu7TUg9Y" alt=""><figcaption><p>running the command will prompt you with an override selection. if you are unsure, please read our guide on <a href="/pages/kkT3aZveUMfS5EX4MGis">overrides</a></p></figcaption></figure>

<figure><img src="/files/EX5vTOwOyHAedjf18VL5" alt=""><figcaption><p>once an override has been selected, the bot will acknowledge your selection</p></figcaption></figure>

### `a!claimtime-admin remove` (`/claimtime-admin remove`)

> This command removes the claimtime set for that particular role. Once this command is used on a role, the whole claimtime is deleted for that specific role completely.&#x20;

<figure><img src="/files/xjDaREPVkZHomIHQFWXR" alt=""><figcaption></figcaption></figure>

### `a!claimtime-admin display (/claimtime-admin display)`

> This command shows the configured claimtime for the roles in the server, however this command only shows the claimtime only for the configured roles as shown below.

<figure><img src="/files/cX8xiyCOWzmmGSmxHdxz" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
**Syntax usage:**

`<>` = Required argument (mandatory and must be included)

`[]` = Optional argument (not necessary to be included)
{% endhint %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.apollo-bot.xyz/guides/claimtime.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.