# Get Scheduled Run

> Check whether a run is scheduled with a key, and when it runs.

- ID: `get_scheduled_run`
- Type: Block
- Category: [Logic](https://inventor.bot/docs/reference/blocks/logic.md)

**Inputs**

| Name | Required | Description | Value |
| --- | --- | --- | --- |
| `key` | yes | The key of the run. | e.g. `"giveaway-123"` |

**Outputs**

| Name | Description | Value |
| --- | --- | --- |
| `scheduled` | Whether a run is scheduled with this key. | e.g. `"true"` |
| `run_at` | When it runs, empty when nothing is scheduled. | e.g. `"1700003600"` |
| `seconds_left` | Seconds until it runs, empty when nothing is scheduled. | e.g. `"3600"` |

**Example**

```go
scheduledRun := get_scheduled_run(Args{key: "giveaway-123"})
send_text_message(Args{
	channel_id:      trigger.channel_id,
	message_content: "Scheduled: " + scheduledRun.scheduled,
})
```