---
title: "Verify API Key and Get Tier Information"
method: GET
path: "/auth/verify/{api_key}"
tags: ["API Key Validation"]
---

# Verify API Key and Get Tier Information

`GET /auth/verify/{api_key}`

Verify an API Key and retrieve its tier information and limits.

This endpoint allows you to:
- Check if an API Key is valid and active
- Get the tier level and associated features
- View configured limits, enforcement status, and usage statistics
- Check expiration date

**Example:**
```
GET /auth/verify/TP-abc123def456...
```

**Response includes:**
- Tier name and level (Premium/Pro/Free)
- Available features for the tier
- Configured per-minute value and its enforcement status
- Enforced monthly limit
- Usage statistics
- Expiration information

## Path parameters

- `api_key` string, required — Your API Key to verify (format: `TP-XXXXX...`)

## Response `200`

API Key is valid

- unknown

## Other responses

- `401` — Invalid or expired API Key
- `404` — API Key not found
- `422` — Validation Error

---

[API](https://skmtc.dev/top-streaming/apis/top-posters-api.md) · [All operations](https://skmtc.dev/top-streaming/apis/top-posters-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/top-streaming/top-posters-api/revisions/f4a4deefa3ca/schema)