---
title: "Get Subscription"
method: GET
path: "/v1/subscription"
tags: ["Billing"]
---

# Get Subscription

`GET /v1/subscription`

## Request

- Base URL: `https://api.racehooks.io`
- URL: `https://api.racehooks.io/v1/subscription`
- Auth: API key in header `Authorization`

Get current subscription tier, plan limits, and live usage snapshot for the authenticated client

## Response `200`

Default Response

- object
  - `data` object
    - `tier` 'free' | 'developer' | 'live' | 'analytics' | 'enterprise'
    - `active` boolean
    - `limits` object
      - `maxWebhooks` union
        - integer
        - string
      - `monthlyDeliveryBucket` union
        - integer
        - string
      - `overageRatePer1kCents` integer
      - `hmacEnabled` boolean
    - `usage` object
      - `period` string
      - `periodStart` string
      - `periodEnd` string
      - `webhookCount` integer
      - `webhooksRemaining` integer, nullable
      - `monthlyDeliveries` integer
      - `bucketRemaining` integer, nullable
      - `overageDeliveries` integer
      - `overageSpendCents` integer
      - `spendCapCents` integer
      - `failureCount` integer
    - `upgrade` object, nullable

## Other responses

- `401`: Unauthorized

---

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