# 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 | Wero","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.type` (string, required)
    Enum: "top_up"

  - `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 | Wero","currencies":["EUR"],"minimum_amount":1,"maximum_amount":5000000,"details":{}}
    - `id` (string, required)
      Example: "ideal"
    - `type` (string, required)
      Enum: "pay_method"
    - `name` (string, required)
      Example: "iDEAL | Wero"
    - `currencies` (array)
      Enum: same as `data.currency` (1 values)
    - `minimum_amount` (integer)
      Example: 1
    - `maximum_amount` (integer)
      Example: 5000000
    - `details` (object)
      Example: {}
    - `details.issuers` (array,null)
    - `details.issuers.code` (string)
    - `details.issuers.name` (string)
    - `details.iban` (string,null)
    - `details.bic` (string,null)
    - `details.account_name` (string,null)
    - `details.routing_number` (string,null)
    - `details.account_number` (string,null)

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

  - `_links` (object, required)

  - `_links.self` (string, required)

  - `_links.next` (string)

  - `_links.prev` (string)