# Retrieves a top-up

Retrieves a single top-up based on the id.

Endpoint: GET /top_ups/{id}
Version: v1
Security: apiKey

## Path parameters:

  - `id` (string, required)
    ID of the top-up

## Response 200 fields (application/json):

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

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

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

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

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

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

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

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

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

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

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

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

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

  - `_links.checkout` (string)

## Response 404 fields (application/json):

  - `error` (object, required)

  - `error.message` (string, required)
    The error message

  - `error.type` (string, required)
    Type of error
    Enum: "invalid_request"