---
title: "Get user scheduled events"
type: reference
method: GET
path: /rest-api/users/{username}/scheduledEvents.do
tag: "Users"
---

# Get user scheduled events

`GET https://YOUR-NETWORK-DOMAIN/rest-api/users/{username}/scheduledEvents.do`

Retrieves all scheduled events configured for the specified user. The response is a JSON object containing 'userId', 'username', and 'scheduledEvents' (an array of event objects). Each event object includes 'id', 'name', 'period' (1=DAY, 2=WEEK, 3=MONTH), 'frequency' (how many times the event fires per period), and 'startAt' (delay in minutes before the first firing).

## Path params

| Name | Type | Required | Example | Description |
|---|---|---|---|---|
| `username` | string | yes | `john.doe` | Login username of the user whose scheduled events should be retrieved — the caller's own, or one whose role the caller's admin role manages |

## Responses

- `200` — Scheduled events retrieved successfully
- `400` — Bad request — invalid or missing parameters
- `401` — Unauthorized - authentication error
- `403` — Forbidden — insufficient permissions
- `404` — No such user, or the user is neither the caller nor an account the caller's admin role manages

## Example request

```bash
curl --request GET \
  --url 'https://YOUR-NETWORK-DOMAIN/rest-api/users/john.doe/scheduledEvents.do' \
  --header 'X-Api-Key: YOUR_API_KEY'
```

Source: https://epom.com/ad-server/docs/api/users/get-users-scheduledevents