# Retrieve a list of top-ups

Retrieve a list of top-ups that have been created for your account. The top-ups are sorted, with the most recent first.

Endpoint: GET /top_ups
Version: v1
Security: apiKey

## Response 200 fields (application/json):

  - `type` (string, required)
    Enum: "list"

  - `data` (array, required)
    Example: [{"id":"TUMKR465ZG6QDU","type":"top_up","amount":12300,"currency":"EUR","description":"Top-up TUMKR465ZG6QDU","pay_method":{"id":"ideal","type":"pay_method","name":"iDEAL","currencies":["EUR"],"minimum_amount":1,"maximum_amount":5000000,"details":{}},"locale":"en","state":"paid","metadata":{},"created_at":"2025-05-28T14:52:26Z","paid_at":"2025-05-28T14:53:03Z","_links":{"self":"http://api.paypro.test:3000/top_ups/TUMKR465ZG6QDU"}}]

  - `data.id` (string, required)
    Example: "TUMKR465ZG6QDU"

  - `data.amount` (integer, required)
    Example: 12300

  - `data.description` (string, required)
    Example: "Top-up TUMKR465ZG6QDU"

  - `data.currency` (string, required)
    Enum: "EUR"

  - `data.pay_method` (any, required)
    Example: {"id":"ideal","type":"pay_method","name":"iDEAL","currencies":["EUR"],"minimum_amount":1,"maximum_amount":5000000,"details":{}}

  - `data.state` (string, required)
    Example: "paid"

  - `data.locale` (string,null, required)
    Enum: "de", "en", "fr", "nl"

  - `data.metadata` (object, required)
    Example: {}

  - `data.paid_at` (string,null, required)
    Example: "2025-05-28T14:53:03Z"

  - `data.created_at` (string,null, required)
    Example: "2025-05-28T14:52:26Z"

  - `data._links` (object, required)
    Example: {"self":"http://api.paypro.test:3000/top_ups/TUMKR465ZG6QDU"}

  - `data._links.self` (string, required)
    Example: "http://api.paypro.test:3000/top_ups/TUMKR465ZG6QDU"

  - `data._links.checkout` (string)

  - `count` (integer, required)