# List test top-ups

List tenant test top-ups with exact balances, refund holds and invoice state

`GET https://tokenlane.de/api/credits/transactions`

## 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
curl --request GET \
  --url 'https://tokenlane.de/api/credits/transactions?id=top_01k7tm3w8vfz6b2r4m9q5xyz7c' \
  --header 'Authorization: Bearer YOUR_API_KEY'
```

## node

```node
const response = await fetch("https://tokenlane.de/api/credits/transactions?id=top_01k7tm3w8vfz6b2r4m9q5xyz7c", {
  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/transactions?id=top_01k7tm3w8vfz6b2r4m9q5xyz7c",
    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/transactions?id=top_01k7tm3w8vfz6b2r4m9q5xyz7c", {
  method: "GET",
  headers: {
    "Authorization": "Bearer " + process.env.TOKENLANE_API_KEY,
  },
});
console.log(await response.text());
```

## query: id (optional)

Top-up ID

### s21: string

Top-up ID

{}

```json
"top_01k7tm3w8vfz6b2r4m9q5xyz7c"
```

## query: status (optional)

### s23: string

"creating", "open", "pending", "authorized", "paid", "canceled", "expired", "failed"

{}

## query: page (optional)

### s24: integer

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

## query: pageSize (optional)

### s25: integer

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

## query: sort (optional)

### s26: string

"date", "amount", "status"

{"default":"\"date\""}

## query: direction (optional)

### s7: string

"asc", "desc"

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

## Response 200: application/json

Request successful

```json
{
  "items": [
    {
      "id": "YOUR_ID",
      "amount": "YOUR_AMOUNT",
      "fee": "YOUR_FEE",
      "total": "YOUR_TOTAL",
      "currency": "EUR",
      "testMode": true,
      "status": "creating",
      "paymentMethod": "YOUR_PAYMENTMETHOD",
      "scaStatus": "unknown",
      "availableAt": "YOUR_AVAILABLEAT",
      "heldAmount": "YOUR_HELDAMOUNT",
      "checkoutUrl": "YOUR_CHECKOUTURL",
      "createdAt": "YOUR_CREATEDAT",
      "kind": "oneoff",
      "refundedAmount": "YOUR_REFUNDEDAMOUNT",
      "reservedRefundAmount": "YOUR_RESERVEDREFUNDAMOUNT",
      "reversedAmount": "0.00",
      "refundableAmount": "YOUR_REFUNDABLEAMOUNT",
      "invoiceStatus": "not_requested",
      "invoiceUrl": "YOUR_INVOICEURL",
      "invoiceNumber": "YOUR_INVOICENUMBER",
      "receiptAvailable": false
    }
  ],
  "total": 0,
  "page": 0,
  "pageSize": 0
}
```

### s27: object

{}

- items (required): s88

### s88: array

{}

### s49: allOf

{}

allOf: s22

### s22: object

{}

- id (required): s35

### s35: string

{}

- amount (required): s35

- fee (required): s35

- total (required): s35

- currency (required): s81

### s81: string

"EUR"

{}

- testMode (required): s83

### s83: boolean

true

{}

- status (required): s23

- paymentMethod (required): s84

### s84: string | null

{"maxLength":"64"}

- scaStatus (required): s85

### s85: string

"unknown", "normal", "3dsecure", "wallet", "mandate", "legacy"

{}

- availableAt (required): s86

### s86: string | null

date-time

{}

- heldAmount (required): s35

- checkoutUrl (required): s87

### s87: string | null

{}

- createdAt (required): s35

allOf: s152

### s152: object

{}

- kind (required): s177

### s177: string

"oneoff", "mandate", "automatic"

{}

- refundedAmount (required): s35

- reservedRefundAmount (required): s35

- reversedAmount (required): s178

### s178: string

Returned outside Tokenlane: Mollie dashboard refunds and chargebacks that were not reversed

{}

```json
"0.00"
```

- refundableAmount (required): s35

- invoiceStatus (required): s94

### s94: string

"not_requested", "pending", "waiting_profile", "creating", "needs_review", "archiving", "ready", "legacy"

{}

- invoiceUrl (required): s87

- invoiceNumber (required): s87

- receiptAvailable (required): s89

### s89: boolean

{}

- total (required): s55

### s55: integer

{}

- page (required): s55

- pageSize (required): s55

## Response 400: application/json

Bad request (validation error, invalid input)

```json
{
  "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

{}

```json
400
```

- code (required): s58

### s58: string

Error code

{}

```json
"VALIDATION_ERROR"
```

- message (required): s59

### s59: string

Error message

{}

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

{}

```json
"title"
```

- message (required): s180

### s180: string

Field error message

{}

```json
"Required"
```

## Response 401: application/json

Authentication required (missing or invalid credentials)

```json
{
  "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

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

## Response 404: application/json

Resource not found

```json
{
  "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)

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

## Response 429: application/json

Retry after the indicated delay

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

## Response 500: application/json

Internal server error

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

## Response 503: application/json

Configured upstream timed out, failed or returned an invalid response

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