---
title: "Get per-team free-pack status"
method: GET
path: "/api/packs/free-status"
tags: ["Packs"]
---

# Get per-team free-pack status

`GET /api/packs/free-status`

## Request

- Base URL: `https://app.d-sports.org`
- URL: `https://app.d-sports.org/api/packs/free-status`
- Auth: HTTP bearer

Authenticated per-user read of free-pack state for the current UTC day, without hitting the cap. Without teamId, one row per team with an active, non-internal, currently-released free pack. With teamId, that team row, or an empty teams array when the team has no active free pack (never 404: native treats 404 as route-not-deployed and hides the clock). Counts share the where clause the 429 path enforces, so remaining matches the cap; purchase and checkout re-count under lock and stay authoritative. Cache-Control: no-store. No quiet-hours window exists yet, so none is honored (#914 follow-up).

## Query parameters

- `teamId` string

## Response `200`

{ success, data: { teams: [{ teamId, limit, used, remaining, resetsAt }] } }. resetsAt is next UTC midnight, ISO 8601, same value as the 429 resetsAt.

## Other responses

- `401`: { success: false, error, code: UNAUTHORIZED }

## Changes

- **2026-11-18** `6de639c52609`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/d-sports-ecosystem/apis/d-sports-api/changes/api/packs/free-status/get.md)

---

[API](https://skmtc.dev/d-sports-ecosystem/apis/d-sports-api.md) - [All operations](https://skmtc.dev/d-sports-ecosystem/apis/d-sports-api/llms.txt) - [OpenAPI document](https://skmtc.dev/d-sports-ecosystem/apis/d-sports-api/revisions/63735cf90a04?raw)
