---
title: "Read the connected account’s email alerts, global pause state, config.version, subscription status and allowed filter values. These are the same alerts as the dashboard."
method: GET
path: "/me/alerts"
---

# Read the connected account’s email alerts, global pause state, config.version, subscription status and allowed filter values. These are the same alerts as the dashboard.

`GET /me/alerts`

## Request

- Base URL: `https://api.hiddenjobs.dev/v1`
- URL: `https://api.hiddenjobs.dev/v1/me/alerts`
- Auth: one of:
  - HTTP bearer
  - OAuth 2 (authorization code, authorization URL `https://api.hiddenjobs.dev/v1/oauth/authorize`, token URL `https://api.hiddenjobs.dev/v1/oauth/token`, scopes: `email`)

## Response `200`

Operation result

- object
  - `data` object, required
    - `config` JobAlertConfig, required
      - `frequency` 'daily' | 'weekly', required
      - `enabled` boolean, required
      - `alerts` JobAlert[], required
        - `name` string, required
        - `frequency` 'daily' | 'weekly', required
        - `enabled` boolean, required
        - `category` string[], required: Match any selected value within this filter. All removes the filter; different filters combine with AND.
        - `employmentType` string[], required: Match any selected value within this filter. All removes the filter; different filters combine with AND.
        - `jobType` string[], required: Match any selected value within this filter. All removes the filter; different filters combine with AND.
        - `remoteLocation` string[], required: Match any selected value within this filter. All removes the filter; different filters combine with AND.
        - `id` string, uuid, required
        - `q` string, required
        - `since` string
        - `next_due_at` string
      - `version` integer, required
      - `next_due_at` string
    - `subscribed` boolean, required
    - `maxAlerts` 5, required
    - `filters` object, required

## Other responses

- `400`: Invalid arguments
- `401`: Invalid credentials
- `403`: Permission denied
- `404`: Record not found
- `409`: Revision, idempotency or state conflict
- `413`: Size or quota limit
- `429`: Request limit
- `503`: Temporarily unavailable

---

[API](https://skmtc.dev/hiddenjobs/apis/hidden-jobs-api.md) · [All operations](https://skmtc.dev/hiddenjobs/apis/hidden-jobs-api/llms.txt) · [OpenAPI document](https://skmtc.dev/hiddenjobs/apis/hidden-jobs-api/revisions/c1d57d8e4720?raw)