--- title: "Retrieve a transaction" method: GET path: "/v0.1/me/transactions" tags: ["Transactions"] deprecated: true --- # Retrieve a transaction `GET /v0.1/me/transactions` > **Deprecated.** Retrieves the full details of an identified transaction. The transaction resource is identified by a query parameter and *one* of following parameters is required: * `id` * `internal_id` * `transaction_code` * `foreign_transaction_id` * `client_transaction_id` ## Query parameters - `id` string - `internal_id` string - `transaction_code` string ## Response `200` Returns the requested transaction resource. - TransactionFull — Additional transaction fields used by history and detailed views. - `id` string — Unique ID of the transaction. - `transaction_code` string — Transaction code returned by the acquirer/processing entity after processing the transaction. - `amount` number, float — Total amount of the transaction. - `currency` 'BGN' | 'BRL' | 'CHF' | 'CLP' | 'COP' | 'CZK' | 'DKK' | 'EUR' | 'GBP' | 'HRK' | 'HUF' | 'NOK' | 'PLN' | 'RON' | 'SEK' | 'USD' — Three-letter [ISO4217](https://en.wikipedia.org/wiki/ISO_4217) code of the currency for the amount. Currently supported currency values are enumerated above. - `timestamp` string, date-time — Date and time of the creation of the transaction. Response format expressed according to [ISO8601](https://en.wikipedia.org/wiki/ISO_8601) code. - `status` 'SUCCESSFUL' | 'CANCELLED' | 'FAILED' | 'PENDING' — Current status of the transaction. - `payment_type` 'CASH' | 'POS' | 'ECOM' | 'RECURRING' | 'BITCOIN' | 'BALANCE' | 'MOTO' | 'BOLETO' | 'DIRECT_DEBIT' | 'APM' | 'UNKNOWN' — Payment type used for the transaction. - `installments_count` integer — Current number of the installment for deferred payments. - `merchant_code` string — Unique code of the registered merchant to whom the payment is made. - `vat_amount` number, float — Amount of the applicable VAT (out of the total transaction amount). - `tip_amount` number, float — Amount of the tip (out of the total transaction amount). - `entry_mode` 'none' | 'magstripe' | 'chip' | 'manual entry' | 'customer entry' | 'magstripe fallback' | 'contactless' | 'moto' | 'contactless magstripe' | 'boleto' | 'direct debit' | 'sofort' | 'ideal' | 'bancontact' | 'eps' | 'mybank' | 'satispay' | 'blik' | 'p24' | 'giropay' | 'pix' | 'qr code pix' | 'apple pay' | 'google pay' | 'paypal' | 'na' — Entry mode of the payment details. - `auth_code` string — Authorization code for the transaction sent by the payment card issuer or bank. Applicable only to card payments. - `internal_id` integer — Internal unique ID of the transaction on the SumUp platform. - `product_summary` string — Short description of the payment. The value is taken from the `description` property of the related checkout resource. - `payouts_total` integer — Total number of payouts to the registered user specified in the `user` property. - `payouts_received` integer — Number of payouts that are made to the registered user specified in the `user` property. - `payout_plan` 'SINGLE_PAYMENT' | 'TRUE_INSTALLMENT' | 'ACCELERATED_INSTALLMENT' — Payout plan of the registered user at the time when the transaction was made. - `foreign_transaction_id` string — External/foreign transaction id (passed by clients). - `client_transaction_id` string — Client transaction id. - `username` string, email — Email address of the registered user (merchant) to whom the payment is made. - `fee_amount` number — Transaction SumUp total fee amount. - `lat` number, float — Latitude value from the coordinates of the payment location (as received from the payment terminal reader). - `lon` number, float — Longitude value from the coordinates of the payment location (as received from the payment terminal reader). - `horizontal_accuracy` number, float — Indication of the precision of the geographical position received from the payment terminal. - `merchant_id` integer — SumUp merchant internal Id. - `device_info` Device — Details of the device used to create the transaction. - `name` string — Device name. - `system_name` string — Device OS. - `model` string — Device model. - `system_version` string — Device OS version. - `uuid` string — Device UUID. - `simple_payment_type` 'CASH' | 'CC_SIGNATURE' | 'ELV' | 'ELV_WITHOUT_SIGNATURE' | 'CC_CUSTOMER_ENTERED' | 'MANUAL_ENTRY' | 'EMV' | 'RECURRING' | 'BALANCE' | 'MOTO' | 'BOLETO' | 'APM' | 'BITCOIN' | 'CARD' — Simple name of the payment type. - `verification_method` 'none' | 'signature' | 'offline PIN' | 'online PIN' | 'offline PIN + signature' | 'na' — Verification method used for the transaction. - `card` CardResponse — Details of the payment card. - `last_4_digits` string — Last 4 digits of the payment card number. - `type` 'ALELO' | 'AMEX' | 'CONECS' | 'CUP' | 'DINERS' | 'DISCOVER' | 'EFTPOS' | 'ELO' | 'ELV' | 'GIROCARD' | 'HIPERCARD' | 'INTERAC' | 'JCB' | 'MAESTRO' | 'MASTERCARD' | 'PLUXEE' | 'SWILE' | 'TICKET' | 'VISA' | 'VISA_ELECTRON' | 'VISA_VPAY' | 'VPAY' | 'VR' | 'UNKNOWN' — Issuing card network of the payment card used for the transaction. - `elv_account` ElvCardAccount — Details of the ELV card account associated with the transaction. - `sort_code` string — ELV card sort code. - `last_4_digits` string — ELV card account number last 4 digits. - `sequence_no` integer — ELV card sequence number. - `iban` string — ELV IBAN. - `local_time` string, date-time — Local date and time of the creation of the transaction. - `payout_date` string, date — The date of the payout. - `payout_type` 'BANK_ACCOUNT' | 'PREPAID_CARD' — Payout type for the transaction. - `process_as` 'CREDIT' | 'DEBIT' — Debit/Credit. - `products` Product[] — List of products from the merchant's catalogue for which the transaction serves as a payment. - `name` string — Product name. - `price_label` string — Product description. - `price` number — Product price. - `vat_rate` number — VAT percentage. - `single_vat_amount` number — VAT amount for a single product. - `price_with_vat` number — Product price incl. VAT. - `vat_amount` number — VAT amount. - `quantity` integer — Product quantity. - `total_price` number — Quantity x product price. - `total_with_vat` number — Total price incl. VAT. - `vat_rates` object[] — List of VAT rates applicable to the transaction. - `rate` number — VAT rate. - `net` number — NET amount of products having this VAT rate applied. - `vat` number — VAT amount of this rate applied. - `gross` number — Gross amount of products having this VAT rate applied. - `transaction_events` TransactionEvent[] — List of transaction events related to the transaction. - `id` integer — Unique ID of the transaction event. - `event_type` 'PAYOUT' | 'CHARGE_BACK' | 'REFUND' | 'PAYOUT_DEDUCTION' — Type of the transaction event. - `status` 'PENDING' | 'SCHEDULED' | 'FAILED' | 'REFUNDED' | 'SUCCESSFUL' | 'PAID_OUT' — Status of the transaction event. - `amount` number — Amount of the event. - `due_date` string, date — Date when the transaction event is due to occur. - `date` string, date — Date when the transaction event occurred. - `installment_number` integer — Consecutive number of the installment that is paid. Applicable only payout events, i.e. `event_type = PAYOUT`. - `timestamp` string, date-time — Date and time of the transaction event. - `simple_status` 'SUCCESSFUL' | 'PAID_OUT' | 'CANCEL_FAILED' | 'CANCELLED' | 'CHARGEBACK' | 'FAILED' | 'REFUND_FAILED' | 'REFUNDED' | 'NON_COLLECTION' | 'PENDING' — Status generated from the processing status and the latest transaction state. - `links` Link[] — List of hyperlinks for accessing related resources. - `rel` string — Specifies the relation to the current resource. - `href` string, uri — URL for accessing the related resource. - `type` string — Specifies the media type of the related resource. - `events` Event[] — List of events related to the transaction. - `id` integer — Unique ID of the transaction event. - `transaction_id` string — Unique ID of the transaction. - `type` 'PAYOUT' | 'CHARGE_BACK' | 'REFUND' | 'PAYOUT_DEDUCTION' — Type of the transaction event. - `status` 'PENDING' | 'SCHEDULED' | 'FAILED' | 'REFUNDED' | 'SUCCESSFUL' | 'PAID_OUT' — Status of the transaction event. - `amount` number, float — Amount of the event. - `timestamp` string, date-time — Date and time of the transaction event. - `fee_amount` number, float — Amount of the fee related to the event. - `installment_number` integer — Consecutive number of the installment. - `deducted_amount` number, float — Amount deducted for the event. - `deducted_fee_amount` number, float — Amount of the fee deducted for the event. - `location` object — Details of the payment location as received from the payment terminal. - `lat` number, float — Latitude value from the coordinates of the payment location (as received from the payment terminal reader). - `lon` number, float — Longitude value from the coordinates of the payment location (as received from the payment terminal reader). - `horizontal_accuracy` number, float — Indication of the precision of the geographical position received from the payment terminal. - `tax_enabled` boolean — Indicates whether tax deduction is enabled for the transaction. ## Other responses - `401` — The request is not authorized. - `404` — The requested resource does not exist. ## Changes - **2026-03-11** `cd79d83b07e0` — 2 warning, 5 info - removed the optional property `error_code` from the response with the `401` status - removed the optional property `message` from the response with the `401` status - added the optional property `detail` to the response with the `401` status - added the optional property `instance` to the response with the `401` status - …3 more - **2026-02-25** `bef1083e0580` — 10 breaking, 9 warning, 19 info - the `allOf[subschema #4]/links/items/` response's property type changed from no type to `object` for status `200` - the `allOf[subschema #4]/products/items/price` response's property format changed from `float` to `decimal` for status `200` - the `allOf[subschema #4]/products/items/price_with_vat` response's property format changed from `float` to `decimal` for status `200` - the `allOf[subschema #4]/products/items/single_vat_amount` response's property format changed from `float` to `decimal` for status `200` - …34 more - …earlier changes not shown [Full history](https://skmtc.dev/sumup/apis/sumup-rest-api/changes/v0.1/me/transactions/get.md) --- [API](https://skmtc.dev/sumup/apis/sumup-rest-api.md) · [All operations](https://skmtc.dev/sumup/apis/sumup-rest-api/llms.txt) · [OpenAPI document](https://skmtc.dev/sumup/apis/sumup-rest-api/revisions/cd79d83b07e0?raw)