List test refunds

List bounded test-refund history for an owned top-up

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

Authorizations

[ [ { "name": "Authorization", "description": "Organization management key: Authorization: Bearer sk-tl-v1-…. Existing sk-eu- keys remain valid. Required scopes are listed in x-scopes; gateway inference keys cannot authorize management operations.", "type": "http bearer", "location": "", "scopes": [] } ] ]

curl

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

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

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

// 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());

path: id (required)

Top-up ID

s21: string

Top-up ID

{}

"top_01k7tm3w8vfz6b2r4m9q5xyz7c"

query: page (optional)

s24: integer

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

query: pageSize (optional)

s25: integer

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

Response 200: application/json

Request successful

{
  "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 (required): s96

s96: array

{}

s34: object

{}

  • id (required): s35

s35: string

{}

  • topupId (required): s35
  • amount (required): s35
  • currency (required): s81

s81: string

"EUR"

{}

  • testMode (required): s83

s83: boolean

true

{}

  • status (required): s97

s97: string

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

{}

  • failureReason (required): s98

s98: string | null

Why the refund is not settled yet or failed, e.g. creation_expired (Mollie never received it; the reserved credit was released) or upstream_unavailable (retrying automatically)

{}

  • createdAt (required): s35
  • total (required): s55

s55: integer

{}

  • page (required): s55
  • pageSize (required): s55

Response 400: application/json

Bad request (validation error, invalid input)

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

s11: object

{}

  • requestId (optional): s56

s56: string

Server correlation ID for an internal error. Also returned in X-Request-Id.

uuid

{}

  • status (required): s57

s57: number

HTTP status code

{}

400
  • code (required): s58

s58: string

Error code

{}

"VALIDATION_ERROR"
  • message (required): s59

s59: string

Error message

{}

"Request validation failed"
  • remedy_hint (optional): s60

s60: string

A safe, actionable remedy from the error catalog.

{}

  • details (optional): s61

s61: array

Detailed validation errors

{}

s154: object

{}

  • path (required): s179

s179: string

Field path

{}

"title"
  • message (required): s180

s180: string

Field error message

{}

"Required"

Response 401: application/json

Authentication required (missing or invalid credentials)

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

Response 403: application/json

Insufficient scope (authenticated but not authorized) | This session can only access security setup until the required factor is verified

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

Response 404: application/json

Resource not found

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

Response 409: application/json

Conflict with the current state (e.g. a name that already exists)

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

Response 429: application/json

Retry after the indicated delay

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

Response 500: application/json

Internal server error

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

Response 503: application/json

Configured upstream timed out, failed or returned an invalid response

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