# Get a clearing transaction

Returns the clearing transaction specified in the request URL.

Endpoint: GET /v1/accounts/{account_id}/clearing_transactions/{clearing_transaction_id}
Version: 1.0

## Path parameters:

  - `account_id` (string, required)

  - `clearing_transaction_id` (string, required)

## Response 200 fields (application/json):

  - `id` (string)
    ID of the clearing transaction.
    Example: "3f4e761f500e4c11a6627b4d90daaec4"

  - `status` (string)
    The status of the clearing transaction.
    Enum: "ACCEPTED", "DECLINED", "EXECUTED", "REVIEW_NEEDED", "CANCELED"

  - `account_id` (string)
    ID of the account for which the transaction was created.
    Example: "06659ff514934b28800b5650d109cacc"

  - `account_iban` (string)
    The account's IBAN.
    Example: "DE43110101005555555555"

  - `clearing_account_iban` (string)
    The clearing account's IBAN.
    Example: "DE30110101001234567890"

  - `amount` (object)
    The amount of the transaction.

  - `amount.value` (integer)
    The amount value.
    Example: 1000

  - `amount.unit` (string)
    The unit of the given value in cents.
    Example: "cents"

  - `amount.currency` (string)
    The currency of the given value. Only EUR is currently supported.
    Example: "EUR"

  - `description` (string)
    A description of the transaction, which is visible to both the sender and the receiver.
    Example: "Example description"

  - `booking_type` (string)
    The type of the booking. See the [booking documentation](https://docs.solarisgroup.com/guides/digital-banking/account-management/#appendix-i-booking-types) for a list of explanations for each booking type.
    Enum: "CANCELLATION_BOOKING", "CancellationCardTransaction", "CANCELLATION_CARD_TRANSACTION_DIRECT", "CANCELLATION_CHARGE_CARD", "CANCELLATION_CHARGE_DUNNING", "CANCELLATION_CHARGE_SEPA_DIRECT_DEBIT_RETURN", "CANCELLATION_CRYPTO_EXCHANGE", "CANCELLATION_CURRENCY_EXCHANGE_PARTNER", "CANCELLATION_DIRECT_DEBIT", "CANCELLATION_DOUBLE_BOOKING", "CANCELLATION_INTERNAL_TRANSFER", "CANCELLATION_INTERNATIONAL_CREDIT_TRANSFER", "CANCELLATION_INTEREST_ACCRUED", "CANCELLATION_INTEREST_ANNUITY", "CANCELLATION_INTEREST_LOAN", "CANCELLATION_LOAN_PAYOUT", "CANCELLATION_REBOOKING", "CANCELLATION_REBOOKING_INTEREST", "CANCELLATION_SEPA_CREDIT_TRANSFER_RETURN", "CANCELLATION_SEPA_DIRECT_DEBIT", "CANCELLATION_SEPA_DIRECT_DEBIT_RETURN", "CANCELLATION_TRANSFER_ANNUITY", "CARD_DIRECT_DEBIT", "CARD_TRANSACTION", "CARD_TRANSACTION_DIRECT", "CASH_DEPOSIT_RETAIL", "CASH_WITHDRAWAL_RETAIL", "CHARGE_ACCOUNT_MAINTENANCE", "CHARGE_CARD", "CHARGE_DUNNING", "ChargeRecallRequest", "CHARGE_SEPA_DIRECT_DEBIT_RETURN", "ClosureBalanceTransfer", "COMMISSION_OVERDRAFT", "CREDIT_TRANSFER_CANCELLATION", "CRYPTO_EXCHANGE", "CURRENCY_EXCHANGE_PARTNER", "DIRECT_DEBIT", "FOREIGN_PAYMENT", "INTEREST_ACCRUED", "INTEREST_ANNUITY", "INTEREST_LOAN", "INTERNAL_TRANSFER", "INTERNATIONAL_CREDIT_TRANSFER", "LOAN_PAYOUT", "REBOOKING", "REBOOKING_INTEREST", "SEPA_CREDIT_TRANSFER", "SEPA_CREDIT_TRANSFER_RETURN", "SEPA_DIRECT_DEBIT", "SEPA_DIRECT_DEBIT_RETURN", "SEPAInstantCreditTransfer", "SepaInstantCreditTransferReturn", "TARGET2_CREDIT_TRANSFER", "TRANSFER_ANNUITY", "OTHER"

  - `valuta_date` (string)
    The valuta date of the transaction.
    Example: "2022-04-22"

  - `transaction_type` (string)
    The type of the transaction.
    Example: "CLEARING_TRANSACTION"

  - `reference` (string)
    UUID reference for the transaction. Acts as an idempotency key.
    Example: "2603037c-e264-46c4-82e8-0d3ebc23a30f"

  - `initiator_reference` (string)
    UUID initiatiors reference for the transaction.
    Example: "2603037c-e264-46c4-82e8-0d3ebc23a30f"

## Response 400 fields (application/json):

  - `id` (string)
    Example: "a95f2aaf-4e0c-4d49-8021-8a16a884ed86"

  - `status` (string)
    Example: "400"

  - `code` (string)
    Example: "build_pagination_headers_failure"

  - `title` (string)
    Example: "Failed to build pagination headers."

  - `detail` (string)
    Example: "Cannot connect to database."

## Response 403 fields (application/json):

  - `id` (string)
    Example: "a95f2aaf-4e0c-4d49-8021-8a16a884ed86"

  - `status` (string)
    Example: "403"

  - `code` (string)
    Example: "unauthorized_action"

  - `title` (string)
    Example: "Unauthorized Action"

  - `detail` (string)
    Example: "Unauthorized action is not allowed."

## Response 404 fields (application/json):

  - `id` (string)
    Example: "a95f2aaf-4e0c-4d49-8021-8a16a884ed86"

  - `status` (string)
    Example: "404"

  - `code` (string)
    Example: "model_not_found"

  - `title` (string)
    Example: "Model Not Found"

  - `detail` (string)
    Example: "Couldn't find 'Solaris::Identification' for id 'bbbcccfff388923eb899a5852df6cidt'."

## Response 500 fields (application/json):

  - `id` (string)
    Example: "e8915041-9d8c-4d96-9dd1-04e8522ecdbf"

  - `status` (string)
    Example: "500"

  - `code` (string)
    Example: "generic_error"

  - `title` (string)
    Example: "Generic Error"

  - `detail` (string)
    Example: "There was an error."