# Testerstattungen auflisten

Begrenzten Verlauf der Testerstattungen einer eigenen Aufladung auflisten

`GET https://tokenlane.de/api/credits/topups/{id}/refunds`

## 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": []
    }
  ]
]

## curl

```curl
curl --request GET \
  --url 'https://tokenlane.de/api/credits/topups/top_01k7tm3w8vfz6b2r4m9q5xyz7c/refunds' \
  --header 'Authorization: Bearer YOUR_API_KEY'
```

## node

```node
const response = await fetch("https://tokenlane.de/api/credits/topups/top_01k7tm3w8vfz6b2r4m9q5xyz7c/refunds", {
  method: "GET",
  headers: {
    "Authorization": "Bearer " + process.env.TOKENLANE_API_KEY,
  },
});
console.log(await response.text());
```

## python

```python
import os
import urllib.request

request = urllib.request.Request(
    "https://tokenlane.de/api/credits/topups/top_01k7tm3w8vfz6b2r4m9q5xyz7c/refunds",
    method="GET",
    headers={
        "Authorization": "Bearer " + os.environ["TOKENLANE_API_KEY"],
    },
)

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/credits/topups/top_01k7tm3w8vfz6b2r4m9q5xyz7c/refunds", {
  method: "GET",
  headers: {
    "Authorization": "Bearer " + process.env.TOKENLANE_API_KEY,
  },
});
console.log(await response.text());
```

## Pfadparameter: id (Pflichtfeld)

Aufladungs-ID

### s21: string

Aufladungs-ID

{}

```json
"top_01k7tm3w8vfz6b2r4m9q5xyz7c"
```

## Abfrageparameter: page (optional)

### s24: integer

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

## Abfrageparameter: pageSize (optional)

### s25: integer

{"minimum":"1","maximum":"100","default":"25"}

## Antwort 200: application/json

Anfrage erfolgreich

```json
{
  "items": [
    {
      "id": "YOUR_ID",
      "topupId": "YOUR_TOPUPID",
      "amount": "YOUR_AMOUNT",
      "currency": "EUR",
      "testMode": true,
      "status": "creating",
      "failureReason": null,
      "createdAt": "YOUR_CREATEDAT"
    }
  ],
  "total": 0,
  "page": 0,
  "pageSize": 0
}
```

### s32: object

{}

- items (Pflichtfeld): s96

### s96: array

{}

### s34: object

{}

- id (Pflichtfeld): s35

### s35: string

{}

- topupId (Pflichtfeld): s35

- amount (Pflichtfeld): s35

- currency (Pflichtfeld): s81

### s81: string

"EUR"

{}

- testMode (Pflichtfeld): s83

### s83: boolean

true

{}

- status (Pflichtfeld): s97

### s97: string

"creating", "queued", "pending", "processing", "refunded", "failed", "canceled"

{}

- failureReason (Pflichtfeld): s98

### s98: string | null

Warum die Erstattung noch aussteht oder fehlgeschlagen ist, z. B. creation_expired (Mollie hat sie nicht erhalten; reserviertes Guthaben wurde freigegeben) oder upstream_unavailable (automatische Wiederholung)

{}

- createdAt (Pflichtfeld): s35

- total (Pflichtfeld): s55

### s55: integer

{}

- page (Pflichtfeld): s55

- 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

Unzureichender Scope (authentifiziert, aber nicht berechtigt) | Diese Sitzung darf nur die Sicherheitseinrichtung aufrufen, bis der erforderliche Faktor verifiziert ist

```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

Konflikt mit dem aktuellen Zustand, beispielsweise ein bereits vorhandener Name.

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

## Antwort 429: application/json

Nach der angegebenen Wartezeit erneut versuchen

```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"
}
```
