---
title: "Delete Subscription"
method: DELETE
path: "/api/subscriptions/{sub_id}"
tags: ["subscriptions"]
---

# Delete Subscription

`DELETE /api/subscriptions/{sub_id}`

## Request

- Base URL: `https://api.fairline.io` (the document declares no server; this is the origin it was published from)
- URL: `https://api.fairline.io/api/subscriptions/{sub_id}`
- Auth: HTTP bearer

Soft-unsubscribe. Returns the updated row.

## Path parameters

- `sub_id` integer, required

## Response `200`

Successful Response

- SubscriptionResponse
  - `id` integer, required
  - `tier` 'game' | 'lineups' | 'starting_soon' | 'logged_bets', required
  - `sport` 'mlb' | 'nhl' | 'epl' | 'nfl', required
  - `external_game_id` string, nullable
  - `game_date` string, date, nullable
  - `active` boolean, required
  - `created_at` string, date-time, required
  - `unsubscribed_at` string, date-time, nullable

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/fairline/apis/fairline-api.md) · [All operations](https://skmtc.dev/fairline/apis/fairline-api/llms.txt) · [OpenAPI document](https://skmtc.dev/fairline/apis/fairline-api/revisions/9f7ed2bfdf75?raw)