# API-Key nachschlagen

Nur lesende Suche mit denselben Mandanten-, Typ-, Eigentümer- und Ablauffiltern wie die Übersicht. Klartext-Keys gehören weder in diesen Anfrageinhalt noch in eine URL.

`POST https://tokenlane.de/api/keys/lookup`

## Authentifizierung

[
  [
    {
      "name": "Authorization",
      "description": "Management-Key der Organisation: `Authorization: Bearer sk-tl-v1-…`. Bestehende `sk-eu-`-Keys bleiben gültig. Erforderliche Scopes stehen in `x-scopes`; Inferenz-Keys berechtigen nicht zu Verwaltungsoperationen.",
      "type": "http bearer",
      "location": "",
      "scopes": []
    }
  ]
]

Werte mit YOUR_ sind Platzhalter. Vor dem Senden durch passende eigene Werte ersetzen.

## curl

```curl
curl --request POST \
  --url 'https://tokenlane.de/api/keys/lookup' \
  --header 'Authorization: Bearer YOUR_API_KEY' \
  --header 'Origin: https://tokenlane.de' \
  --header 'Content-Type: application/json' \
  --data '{
  "workspaceId": "wsp_01k7tm3w8vfz6b2r4m9q5xyz7c",
  "keyHash": "YOUR_KEYHASH"
}'
```

## node

```node
const response = await fetch("https://tokenlane.de/api/keys/lookup", {
  method: "POST",
  headers: {
    "Authorization": "Bearer " + process.env.TOKENLANE_API_KEY,
    "Origin": "https://tokenlane.de",
    "Content-Type": "application/json",
  },
  body: `{
  "workspaceId": "wsp_01k7tm3w8vfz6b2r4m9q5xyz7c",
  "keyHash": "YOUR_KEYHASH"
}`,
});
console.log(await response.text());
```

## python

```python
import os
import urllib.request

body = (r'''{
  "workspaceId": "wsp_01k7tm3w8vfz6b2r4m9q5xyz7c",
  "keyHash": "YOUR_KEYHASH"
}''').encode("utf-8")

request = urllib.request.Request(
    "https://tokenlane.de/api/keys/lookup",
    method="POST",
    headers={
        "Authorization": "Bearer " + os.environ["TOKENLANE_API_KEY"],
        "Origin": "https://tokenlane.de",
        "Content-Type": "application/json",
    },
    data=body,
)

with urllib.request.urlopen(request) as response:
    print(response.read().decode("utf-8"))
```

## vercel

```vercel
// This operation uses HTTP directly.
const response = await fetch("https://tokenlane.de/api/keys/lookup", {
  method: "POST",
  headers: {
    "Authorization": "Bearer " + process.env.TOKENLANE_API_KEY,
    "Origin": "https://tokenlane.de",
    "Content-Type": "application/json",
  },
  body: `{
  "workspaceId": "wsp_01k7tm3w8vfz6b2r4m9q5xyz7c",
  "keyHash": "YOUR_KEYHASH"
}`,
});
console.log(await response.text());
```

## Anfrageinhalt: application/json

```json
{
  "workspaceId": "wsp_01k7tm3w8vfz6b2r4m9q5xyz7c",
  "keyHash": "YOUR_KEYHASH"
}
```

### s17: object

{"additionalProperties":"false"}

- q (optional): s0

### s0: string

In Name und Anzeigepräfix suchen. Vollständige Keys nie senden. Stattdessen die SHA-256-Suche verwenden.

{"maxLength":"100"}

- owner (optional): s77

### s77: anyOf

{}

anyOf: s51

### s51: string

"me", "workspace"

{}

anyOf: s52

### s52: string

Nach einem Organisationsmitglied filtern

{}

```json
"mem_01k7tm3w8vfz6b2r4m9q5xyz7c"
```

- expiration (optional): s2

### s2: string

Ablauffilter nach der Datenbankuhr: `never` hat kein `expires_at`, `expired` hat es erreicht (der Zeitpunkt selbst zählt wie im Gateway), `scheduled` liegt in der Zukunft

"never", "expired", "scheduled"

{}

- isManagement (optional): s3

### s3: string

Key-Typ einschränken. Ohne Angabe bleibt die kombinierte bisherige Liste erhalten.

"true", "false"

{}

- workspaceId (optional): s4

### s4: string

Nur Keys dieses Workspaces

{}

```json
"wsp_01k7tm3w8vfz6b2r4m9q5xyz7c"
```

- status (optional): s5

### s5: string

`active` sind aktivierte, nicht abgelaufene Keys, die das Gateway annimmt; `disabled` sind gesperrte Keys unabhängig vom Ablauf. Ohne Status bleiben aktivierte abgelaufene Keys in der Liste; mit `expiration=expired` lassen sie sich finden.

"active", "disabled"

{}

- sort (optional): s6

### s6: string

"name", "createdAt"

{"default":"\"createdAt\""}

- order (optional): s7

### s7: string

"asc", "desc"

{"default":"\"desc\""}

- page (optional): s8

### s8: integer

{"minimum":"1","maximum":"1000000","default":"1"}

- pageSize (optional): s9

### s9: integer

{"default":"20"}

- keyHash (Pflichtfeld): s78

### s78: string

Lokal berechneter SHA-256-Hash. Den Klartext-Key nie senden.

{"pattern":"\"^[a-f0-9]{64}$\""}

## Antwort 200: application/json

Anfrage erfolgreich

```json
{
  "items": [
    {
      "id": "key_01k7tm3w8vfz6b2r4m9q5xyz7c",
      "name": "Production backend",
      "keyPrefix": "sk-tl-v1-4fKq",
      "workspace": {
        "id": "wsp_01k7tm3w8vfz6b2r4m9q5xyz7c",
        "name": "Default"
      },
      "isManagement": false,
      "owner": {
        "kind": "workspace"
      },
      "usage": {
        "currency": "EUR",
        "lastUsedAt": "YOUR_LASTUSEDAT",
        "totalPicoEur": "YOUR_TOTALPICOEUR",
        "periodPicoEur": "YOUR_PERIODPICOEUR",
        "periodStartsAt": "YOUR_PERIODSTARTSAT",
        "asOf": "YOUR_ASOF"
      },
      "disabled": false,
      "policy": {
        "allowed_models": [
          "deepseek/deepseek-v4.1-flash",
          "mistralai/*"
        ],
        "denied_models": [
          "openai/*"
        ],
        "allowed_countries": [
          "DE",
          "FR"
        ],
        "expires_at": "2026-12-31T23:59:59Z",
        "limit": "25"
      },
      "createdAt": "YOUR_CREATEDAT",
      "updatedAt": "YOUR_UPDATEDAT"
    }
  ],
  "total": 0,
  "page": 0,
  "pageSize": 0
}
```

### s10: object

{}

- items (Pflichtfeld): s53

### s53: array

{}

### s15: object

{}

- id (Pflichtfeld): s66

### s66: string

Key-Identität, nie der Key selbst

{}

```json
"key_01k7tm3w8vfz6b2r4m9q5xyz7c"
```

- name (Pflichtfeld): s67

### s67: string

{}

```json
"Production backend"
```

- keyPrefix (Pflichtfeld): s68

### s68: string

Anfang des Keys zur Wiedererkennung

{}

```json
"sk-tl-v1-4fKq"
```

- workspace (Pflichtfeld): s69

### s69: object

Workspace, zu dem der Key gehört

{}

- id (Pflichtfeld): s100

### s100: string

{}

```json
"wsp_01k7tm3w8vfz6b2r4m9q5xyz7c"
```

- name (Pflichtfeld): s103

### s103: string

{}

```json
"Default"
```

- isManagement (Pflichtfeld): s70

### s70: boolean

Verwaltet Keys der Organisation und kann keine Modelle aufrufen.

{}

- owner (Pflichtfeld): s71

### s71: oneOf

Beim Erstellen gewählte Zuordnung innerhalb der Organisation

{}

oneOf: s155

### s155: object

{}

- kind (Pflichtfeld): s170

### s170: string

"workspace"

{}

oneOf: s156

### s156: object

{}

- kind (Pflichtfeld): s172

### s172: string

"member"

{}

- memberId (Pflichtfeld): s35

### s35: string

{}

- userId (Pflichtfeld): s35

- name (Pflichtfeld): s35

- email (Pflichtfeld): s35

- usage (Pflichtfeld): s43

### s43: object

{}

- currency (Pflichtfeld): s81

### s81: string

"EUR"

{}

- lastUsedAt (Pflichtfeld): s138

### s138: string | null

Erstellungszeitpunkt der neuesten Generierung. Nie der Zeitpunkt einer Verwaltungsänderung.

date-time

{}

- totalPicoEur (Pflichtfeld): s139

### s139: string | null

Alle aufgezeichneten Key-Kosten als ganze Pico-EUR. Null, wenn nicht verfügbar.

{"pattern":"\"^\\\\d+$\""}

- periodPicoEur (Pflichtfeld): s140

### s140: string | null

Aufgezeichnete Kosten im aktuellen UTC-Zeitfenster der Regeln. Ohne Zurücksetzen über die gesamte Laufzeit.

{"pattern":"\"^\\\\d+$\""}

- periodStartsAt (Pflichtfeld): s86

### s86: string | null

date-time

{}

- asOf (Pflichtfeld): s141

### s141: string | null

Zeitpunkt der Abrechnungsprojektion. Null bei Antworten auf Änderungen oder wenn nicht anwendbar.

date-time

{}

- disabled (Pflichtfeld): s72

### s72: boolean

Gesperrte Keys werden vom Gateway abgelehnt.

{}

- policy (Pflichtfeld): s40

### s40: object

Regeln eines Keys in der vom Gateway gelesenen Form (gw_core::KeyPolicy). Unbekannte Felder werden abgelehnt. Für eine Anfrage gilt die Schnittmenge aus Organisations-, Workspace- und Key-Policy: Jede Ebene darf nur weiter einschränken.

{"additionalProperties":"false"}

- bridges (optional): s106

### s106: object

Automatische Umwandlungen je Brücke (`file-parser`: PDF zu Text). Innere Ebenen können nur einschränken: ein strengerer Modus oder eine niedrigere Kostengrenze.

{"additionalProperties":"false"}

- file-parser (optional): s41

### s41: object

Einschränkungen für eine Brücke auf einer Ebene.

{"additionalProperties":"false"}

- mode (optional): s128

### s128: string

`auto` wandelt nur um, wenn der Request sonst scheitern würde, `opt_in` nur, wenn der Request das Plugin aktiviert, `off` nie. Weggelassen: `auto`.

"off", "opt_in", "auto"

{}

- max_auto_cost (optional): s129

### s129: string | null

Höchste automatische Reservierung in EUR als Dezimalstring; null oder weggelassen übernimmt die konfigurierte Grenze. Ausdrücklich angefragte Plugins begrenzt sie nicht.

{}

```json
"0.05"
```

- locked (optional): s130

### s130: boolean

Requests können eine wirksame automatische Brücke nicht abschalten. Innere Ebenen können die Brücke wie immer weiter einschränken, aber nie lockern.

{}

- byok (optional): s107

### s107: boolean | null

Finanzierung: true verlangt BYOK; false verbietet BYOK; null übernimmt die übergeordnete Regel.

{}

- allowed_models (optional): s108

### s108: array

Modell-IDs oder Muster, die der Key verwenden darf. `*` steht für beliebige Werte. Ohne Angabe ist jedes Modell erlaubt.

{"minItems":"1","maxItems":"200"}

```json
[
  "deepseek/deepseek-v4.1-flash",
  "mistralai/*"
]
```

### s163: string

{"minLength":"1","maxLength":"256"}

```json
"mistralai/*"
```

- denied_models (optional): s109

### s109: array

Modell-IDs oder Muster, die trotz Übereinstimmung mit `allowed_models` abgelehnt werden. Eine Ablehnung auf irgendeiner Ebene hat immer Vorrang.

{"maxItems":"200"}

```json
[
  "openai/*"
]
```

- allowed_providers (optional): s110

### s110: array

Provider, die Anfragen bedienen dürfen, benannt wie `provider.only` (Provider-ID oder `provider/variant` für eine Tarifvariante). Nicht angegeben: alle Provider.

{"minItems":"1","maxItems":"200"}

### s164: string

{"minLength":"1","maxLength":"128"}

```json
"mistral"
```

- denied_providers (optional): s111

### s111: array

Provider, die keine Anfragen bedienen dürfen, benannt wie `provider.ignore`.

{"maxItems":"200"}

- allowed_countries (optional): s112

### s112: array

Länder, in denen verarbeitet werden darf (ISO 3166-1 Alpha-2, Großbuchstaben). Eine Route kommt nur infrage, wenn sie ihre Verarbeitungsländer nennt und alle in der Liste stehen.

{"minItems":"1","maxItems":"249"}

```json
[
  "DE",
  "FR"
]
```

### s165: string

{"pattern":"\"^[A-Z]{2}$\""}

```json
"DE"
```

- min_compliance (optional): s113

### s113: string

Schwächste zulässige Einstufung der Rechtsordnung einer Route, in aufsteigender Reihenfolge: `global` (uneingeschränkt), `eu_data_residency`, `eu_operated` oder `sovereign_eu`.

"global", "eu_data_residency", "eu_operated", "sovereign_eu"

{}

- require_zdr (optional): s114

### s114: boolean

Nur Routen ohne Aufbewahrung von Prompt- und Antwortinhalten.

{}

- deny_training (optional): s115

### s115: boolean

Routen ausschließen, deren Provider Kundendaten möglicherweise zum Training nutzt (auch bei unbekanntem Status).

{}

- max_price (optional): s42

### s42: object

Höchste akzeptierte Routenpreise in EUR als Dezimalstrings; eine Anfrage darf sie nicht erhöhen.

{"additionalProperties":"false"}

- prompt (optional): s131

### s131: string

EUR pro Million Eingabetokens.

{}

```json
"25"
```

- completion (optional): s132

### s132: string

EUR pro Million Ausgabetokens.

{}

```json
"25"
```

- request (optional): s133

### s133: string

EUR pro Upstream-Anfrage.

{}

```json
"25"
```

- image (optional): s134

### s134: string

EUR pro Eingabebild.

{}

```json
"25"
```

- audio (optional): s135

### s135: string

EUR pro von der Route festgelegter Einheit der Audioeingabe.

{}

```json
"25"
```

- page (optional): s136

### s136: string

EUR je OCR-Seite.

{}

```json
"25"
```

- character (optional): s137

### s137: string

EUR je PII-Eingabezeichen.

{}

```json
"25"
```

- forbid_capture (optional): s116

### s116: boolean

Prompts und Antworten dürfen nicht gespeichert werden, unabhängig von `capture` am Key.

{}

- default_sort (optional): s117

### s117: string

Standard für `provider.sort`, wenn die Anfrage keinen Wert nennt.

"price", "throughput", "latency"

{}

- default_allow_fallbacks (optional): s118

### s118: boolean

Standard für `provider.allow_fallbacks`, wenn die Anfrage keinen Wert nennt.

{}

- locked (optional): s119

### s119: array

Routing-Standards dieser Policy, die Anfragen und innere Ebenen nicht überschreiben dürfen. Für jede hier aufgeführte Einstellung muss dieselbe Policy einen Standardwert enthalten.

{}

### s166: string

"sort", "allow_fallbacks"

{}

- rate_limits (optional): s120

### s120: object

{"additionalProperties":"false"}

- rpm (optional): s167

### s167: integer | null

{"minimum":"1","maximum":"4294967295"}

- tpm (optional): s167

- max_parallel_requests (optional): s167

- pii_redact (optional): s121

### s121: array

Vom Betreiber eingerichtete, erzwungene Unkenntlichmachung. Lesen und Bearbeiten in der Verwaltung bewahren vorhandene Regeln; Änderungen dieser Regeln erfordern eine Betreiberprüfung der Detektor- und Providerkonfiguration.

{"maxItems":"16"}

### s168: object

{"additionalProperties":"false"}

- when (optional): s184

### s184: object

{"additionalProperties":"false"}

- below_compliance (optional): s191

### s191: string | null

Schwächste zulässige Einstufung der Rechtsordnung einer Route, in aufsteigender Reihenfolge: `global` (uneingeschränkt), `eu_data_residency`, `eu_operated` oder `sovereign_eu`.

"global", "eu_data_residency", "eu_operated", "sovereign_eu", null

{}

- providers_except (optional): s192

### s192: array | null

{"maxItems":"128"}

- models (optional): s193

### s193: array | null

{"minItems":"1","maxItems":"128"}

- entities (optional): s185

### s185: array

{"minItems":"1"}

### s194: string

"person", "address", "email", "phone", "iban", "identifier", "date_of_birth", "organization"

{}

- threshold (optional): s186

### s186: number

{"minimum":"0","maximum":"1"}

- restore (optional): s89

### s89: boolean

{}

- expires_at (optional): s122

### s122: string

Ab diesem Zeitpunkt wird der Key abgelehnt (RFC 3339).

date-time

{}

```json
"2026-12-31T23:59:59Z"
```

- allow_attribution_export (optional): s123

### s123: boolean | null

Der Export von Zuordnungsdaten des Aufrufers erfordert die globale Freigabe durch den Betreiber und die ausdrückliche Zustimmung des Keys mit true. false in Organisation, Workspace oder Key verhindert den Export; ein fehlender Wert oder null erbt die Vorgabe, ohne die Zustimmung des Keys zu erteilen.

{}

- capture (optional): s124

### s124: boolean

Ob Prompts und Antworten dieses Keys für den späteren Abruf gespeichert werden.

{}

- limit (optional): s125

### s125: string

EUR-Ausgabenlimit als Dezimalzeichenkette.

{}

```json
"25"
```

- limit_reset (optional): s126

### s126: string

UTC-Zeitfenster, nach dem die auf `limit` angerechneten Ausgaben bei 0 beginnen. Wochen beginnen am Montag.

"daily", "weekly", "monthly"

{}

- server_tools (optional): s127

### s127: array

Vom Key verwendbare Server-Tools. Sie kosten zusätzlich und senden Teile der Anfrage an Dritte.

{}

### s169: string

"web_search"

{}

- createdAt (Pflichtfeld): s73

### s73: string

Erstellungszeitpunkt

date-time

{}

- updatedAt (Pflichtfeld): s74

### s74: string

Zeitpunkt der letzten Aktualisierung

date-time

{}

- total (Pflichtfeld): s54

### s54: integer

Anzahl der zu den Filtern passenden Keys

{}

- page (Pflichtfeld): s55

### s55: integer

{}

- pageSize (Pflichtfeld): s55

## Antwort 400: application/json

Ungültige Anfrage: Validierungsfehler oder ungültige Eingabe.

```json
{
  "status": 400,
  "code": "VALIDATION_ERROR",
  "message": "Request validation failed"
}
```

### s11: object

{}

- requestId (optional): s56

### s56: string

Serverseitige Zuordnungs-ID für einen internen Fehler. Auch in X-Request-Id enthalten.

uuid

{}

- status (Pflichtfeld): s57

### s57: number

HTTP-Statuscode

{}

```json
400
```

- code (Pflichtfeld): s58

### s58: string

Fehlercode

{}

```json
"VALIDATION_ERROR"
```

- message (Pflichtfeld): s59

### s59: string

Fehlermeldung

{}

```json
"Request validation failed"
```

- remedy_hint (optional): s60

### s60: string

Sichere, ausführbare Abhilfe aus dem Fehlerkatalog.

{}

- details (optional): s61

### s61: array

Detaillierte Validierungsfehler

{}

### s154: object

{}

- path (Pflichtfeld): s179

### s179: string

Feldpfad

{}

```json
"title"
```

- message (Pflichtfeld): s180

### s180: string

Fehlermeldung zum Feld

{}

```json
"Required"
```

## Antwort 401: application/json

Authentifizierung erforderlich: Zugangsdaten fehlen oder sind ungültig.

```json
{
  "status": 400,
  "code": "VALIDATION_ERROR",
  "message": "Request validation failed"
}
```

## Antwort 403: application/json

Berechtigungsumfang reicht nicht aus: authentifiziert, aber nicht berechtigt.

```json
{
  "status": 400,
  "code": "VALIDATION_ERROR",
  "message": "Request validation failed"
}
```

## Antwort 404: application/json

Ressource nicht gefunden

```json
{
  "status": 400,
  "code": "VALIDATION_ERROR",
  "message": "Request validation failed"
}
```

## Antwort 409: application/json

Aktuell veröffentlichte Bedingungen vor Fortsetzen dieser Sitzung lesen und akzeptieren

```json
{
  "status": 400,
  "code": "VALIDATION_ERROR",
  "message": "Request validation failed"
}
```

## Antwort 500: application/json

Interner Serverfehler

```json
{
  "status": 400,
  "code": "VALIDATION_ERROR",
  "message": "Request validation failed"
}
```

## Antwort 503: application/json

Konfigurierter Upstream hat das Zeitlimit überschritten, ist fehlgeschlagen oder hat eine ungültige Antwort geliefert.

```json
{
  "status": 400,
  "code": "VALIDATION_ERROR",
  "message": "Request validation failed"
}
```
