---
title: "Create Subscription"
method: POST
path: "/api/subscriptions"
tags: ["subscriptions"]
---

# Create Subscription

`POST /api/subscriptions`

## 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`
- Auth: HTTP bearer

## Request body

- SubscriptionCreate
  - `tier` 'game' | 'lineups' | 'starting_soon' | 'logged_bets', required
  - `sport` 'mlb' | 'nhl' | 'epl' | 'nfl', required
  - `external_game_id` string, nullable
  - `game_date` string, date, nullable

## 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)