---
operation_id: get_trial_key_status
method: GET
path: /v1/keys/trial/{key}
summary: Rest-Laufzeit + Verbrauch eines Trial-Keys
tags: [keys]
stability: beta
since_version: 0.1.0
auth: none
data_product: platform
snapshot_aware: false
attribution_block: false
rate_limit_tier: public
related:
  - /v1/keys/trial
---
# `GET /v1/keys/trial/{key}` — Trial-Key-Status

Status eines per `POST /v1/keys/trial` geminteten Keys: Rest-Laufzeit,
Requests heute/gesamt, deklarierte Limits. Gedacht für Client-UIs, die dem
Nutzer „deine Lizenz: noch 5 Tage" zeigen wollen.

```bash
curl https://api.lodapi.de/v1/keys/trial/lod_td8j5b86m6s32ujqbdmf8wwah5sv99xd
```

Response (200):

```json
{
  "key_prefix": "lod_td8j5b86",
  "tier": "trial",
  "status": "active",
  "created_at": "2026-07-07T10:12:01Z",
  "expires_at": "2026-07-14T10:12:01Z",
  "seconds_remaining": 604784,
  "requests_today": 1,
  "requests_total": 1,
  "limits": { "requests_per_minute": 60, "requests_per_day": 5000 }
}
```

- **`status`**: `active` | `expired` | `revoked`. Auch abgelaufene/revozierte
  Keys antworten mit 200 + Status (die UI soll „abgelaufen" anzeigen können);
  nur unbekannte oder malformte Keys geben `404`.
- **Privacy**: Der Klartext-Key steht im Pfad, wird aber im Usage-Log als
  `/v1/keys/trial/{key}` redigiert und nirgends persistiert.
- **Zählung**: `requests_today` zählt ab Mitternacht UTC (`date_trunc('day')`),
  `requests_total` über die Key-Lebenszeit — beides aus `api_key_usage`.