---
title: "Read an unsubscribe link"
method: GET
path: "/api/v1/notifications/unsubscribe"
tags: ["Notifications"]
---

# Read an unsubscribe link

`GET /api/v1/notifications/unsubscribe`

## Request

- Base URL: `https://app.easyscraper.com`
- URL: `https://app.easyscraper.com/api/v1/notifications/unsubscribe`
- Auth: none required

The category of emails an unsubscribe link from a notification email turns off, whether its user gets them now (`email`), and whether they get the category on other channels too (`otherChannels`: the notification center, or a client's, like push notifications), which unsubscribing leaves as they are. Changes nothing, so link scanners that open the page can't unsubscribe anyone. Returns `NOT_FOUND` for tokens this app didn't make

## Query parameters

- `token` string, required

## Response `200`

OK

- object
  - `category` 'security' | 'membership' | 'team' | 'billing' | 'feedback', required
  - `email` boolean, required
  - `otherChannels` boolean, required

## Other responses

- `400`: 400
- `404`: 404
- `429`: 429

## Changes

- **2026-11-02** `a12cef98c52b`: 2 info
  - added the non-success response with the status `400`
  - added the required property `otherChannels` to the response with the `200` status
- **2026-10-31** `3e642e95991a`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/easyscraper/apis/easy-scraper-api/changes/api/v1/notifications/unsubscribe/get.md)

---

[API](https://skmtc.dev/easyscraper/apis/easy-scraper-api.md) - [All operations](https://skmtc.dev/easyscraper/apis/easy-scraper-api/llms.txt) - [OpenAPI document](https://skmtc.dev/easyscraper/apis/easy-scraper-api/revisions/a12cef98c52b?raw)