---
title: "Retrieve a transaction"
method: GET
path: "/transactions/{transaction_id}"
tags: ["Transactions"]
---

# Retrieve a transaction

`GET /transactions/{transaction_id}`

Every time you submit a payment request, including, card, recurring payments, Google Pay, Apple Pay, you are returned a `transaction_id`. Append the `transaction_id` to the URL to retrieve the transaction details.

## Path parameters

- `transaction_id` string, uuid, required

## Query parameters

- `filter` string

## Response `200`

OK

- Transaction
  - `transaction_id` string, uuid — Unique identifier assigned by Acquired.com for the transaction.
  - `status` 'blocked' | 'declined' | 'success' | 'tds_error' | 'tds_expired' | 'tds_failed' | 'settled' | 'executed' | 'cancelled' | 'expired' — The current status of the transaction.
  - `reason` '6012_data' | 'above_max_amount' | 'above_max_refund_amount' | 'above_max_transactions' | 'acs_technical_issue' | 'bad_gateway' | 'below_min_amount' | 'below_min_refund_amount' | 'bin_bank' | 'bin_country' | 'bin_level' | 'bin_product' | 'bin_scheme' | 'blocklist_bin' | 'blocklist_card' | 'blocklist_email' | 'blocklist_ip' | 'blocklist_phone' | 'card_authentication_failed' | 'card_not_active' | 'cardholder_cancellation' | 'cardholder_cancelled' | 'challenge_failed' | 'challenge_limit_exceeded' | 'challenge_not_completed' | 'challenge_time_out' | 'closed_account' | 'exceeds_authentication_frequency_limit' | 'exceeds_max_amount' | 'exceeds_max_refund_amount' | 'exceeds_max_transactions' | 'expired_card' | 'fraud_scoring' | 'fraud_scoring_error' | 'generic_decline' | 'insufficient_funds' | 'invalid_avs' | 'invalid_card_number' | 'invalid_cvv' | 'invalid_pin' | 'invalid_transaction' | 'low_confidence' | 'lost_or_stolen' | 'max_amount_day' | 'max_amount_month' | 'max_card_attempts' | 'max_card_success' | 'max_daily_refunds_amount' | 'max_daily_refunds_count' | 'max_email_day' | 'max_email_month' | 'max_ip_day' | 'max_ip_month' | 'max_monthly_refunds_amount' | 'max_monthly_refunds_count' | 'max_phone_day' | 'max_phone_month' | 'max_post_day' | 'max_post_month' | 'max_refunds_count' | 'medium_confidence' | 'no_card_record' | 'restricted_card' | 'scheme_status_reason' | 'security_failure' | 'suspected_fraud' | 'transaction_disputed' | 'transaction_fraud' | 'transaction_not_permitted_to_cardholder'
  - `mid` 'card', uuid — Unique ID assigned by Acquired.com for the associated MID.
  - `payment_method` 'card' | 'apple_pay' | 'google_pay' | 'mastercard_send' | 'visa_direct' | 'faster_payment_send' | 'pay_by_bank' | 'direct_debit' — Detail of how the transaction has been executed.
  - `transaction_type` 'sale' | 'authorisation' | 'capture' | 'refund' | 'void' | 'credit' | 'account_to_account' | 'reversal' — The detail of what type of transaction was performed (such as receiving or sending funds).
  - `transaction` object
    - `order_id` string — Unique reference assigned by you for the payment request.
    - `amount` number, float — The total amount charged.
    - `currency` 'aed' | 'aud' | 'cad' | 'chf' | 'cny' | 'dkk' | 'eur' | 'gbp' | 'hkd' | 'jpy' | 'mxn' | 'sek' | 'usd' | 'zar' — ISO 4217 currency code in lower case.
    - `capture` boolean — Set to false if you want to just authorise and request a funds transfer later.
    - `billing` object — Links the transaction to Acquired Billing. Only returned for transactions initiated by the billing engine (subscription payments and payment recoveries) and omitted for all other transactions. Each field is only included when set.
      - `subscription_id` string — Unique ID (ULID) of the subscription the payment was taken for.
      - `bill_id` string — Unique ID (ULID) of the bill the payment settles.
      - `recovery_id` string — Unique ID (ULID) of the payment recovery. Only present when the transaction was a payment recovery attempt.
  - `check` object
    - `avs_line1` 'matched' | 'not_matched' | 'not_checked' | 'not_provided'
    - `avs_postcode` 'matched' | 'not_matched' | 'not_checked' | 'not_provided'
    - `cvv` 'matched' | 'not_matched' | 'not_checked' | 'not_provided'
  - `retry_advice` RetryAdvice, nullable — Canonical retry advice derived from the acquirer's Advice Code. Present when enabled on your merchant account (contact the support team to enable); null when no advice was returned by the acquirer.
    - `category` 'update_credentials' | 'retry_later' | 'do_not_retry' | 'token_requirements_not_met' | 'cancelled' | 'not_eligible' | 'scheme_blocked' | 'card_product_limitations' | 'customer_action_required' | 'update_details' | 'unknown' — Canonical advice category.
    - `detail` 'lifecycle' | 'policy' | 'fraud_security' | 'non_reloadable_prepaid' | 'single_use_virtual_card' | 'multi_use_virtual_card' | 'card_product_not_supported_by_merchant', nullable — Additional detail within the category, e.g. non_reloadable_prepaid. Null when no further detail applies.
    - `retry_after` string, date-time, nullable — Earliest UTC timestamp after which the transaction may be retried. Null when the category is not retry_later.
    - `acquirer_code` string, nullable — The normalised acquirer-specific advice code (e.g. "25"). Null when no code was provided.
  - `tds` object
    - `status` 'success' — The current status of the transaction.
    - `eci` '00' | '01' | '02' | '05' | '06' | '07' — Indicates the outcome of the transaction.
    - `reason` 'challenge_not_completed' | 'soft_decline' | 'bad_gateway' | 'challenge_failed' | 'acs_technical_issue' | 'challenge_limit_exceeded' | 'invalid_transaction' | 'low_confidence' | 'no_card_record' | 'security_failure' | 'suspected_fraud' | 'soft_decline' — The associated reason to the status, that provides more detail as to what has occurred.
  - `issuer_response_code` '00' | '01' | '02' | '03' | '04' | '05' | '06' | '07' | '08' | '09' | '10' | '11' | '12' | '13' | '14' | '15' | '16' | '17' | '18' | '19' | '20' | '21' | '22' | '23' | '24' | '25' | '26' | '27' | '28' | '29' | '30' | '31' | '32' | '33' | '34' | '35' | '36' | '37' | '38' | '39' | '40' | '41' | '42' | '43' | '44' | '51' | '52' | '53' | '54' | '55' | '56' | '57' | '59' | '60' | '61' | '62' | '63' | '64' | '65' | '66' | '67' | '68' | '75' | '76' | '77' | '80' | '81' | '82' | '83' | '84' | '85' | '86' | '87' | '88' | '89' | '90' | '91' | '92' | '93' | '94' | '95' | '96' | '97' | '98' | '99' | 'N0' | 'N3' | 'N4' | 'N7' | 'P5' | 'P6' | 'XA' | 'XD'
  - `authorisation_code` string — Credit card code to indicate whether the transaction has been approved or declined.
  - `acquirer_reference_number` string — Unique reference number assigned to the transaction as it moves through the payment flow.
  - `scheme_reference_data` string — Unique reference generated by the card scheme.
  - `card_id` string, uuid — Unique ID assigned by Acquired.com for the card.
  - `payment` object
    - `reference` string — The reference to appear on the account holder's bank statement.
    - `payee_id` string — Unique identifier assigned by Acquired.com for the payee record.
    - `aspsp_id` 'santander' | 'bank_of_scotland' | 'first_direct' | 'halifax' | 'hsbc' | 'lloyds' | 'monzo' | 'nationwide' | 'natwest' | 'starling_bank' | 'revolut' | 'rbs' | 'tsb' — The unique identifier assigned by Acquired.com of the bank which the user wants to pay with.
  - `payer` object
    - `account_name` string — The account holder's name, as it appears on their bank account.
    - `account_number` string — The customer's bank account number.
    - `sort_code` string — The sort code of the customer's bank account.
  - `card` CardMasked
    - `holder_name` string — The name of the cardholder.
    - `scheme` 'visa' | 'mastercard' | 'amex' — The scheme the card belongs to.
    - `number` string — The last 4 digits of the card number.
    - `expiry_month` integer — The month the card expires in.
    - `expiry_year` integer — The year the card expires in.
  - `bin` Bin
    - `number` string — The first 6 digits of the card number.
    - `scheme` 'visa' | 'mastercard' | 'amex' — The scheme the card belongs to.
    - `type` 'charge' | 'credit' | 'debit' | 'deferred_debit' | 'prepaid' — The type of card used in the request.
    - `product` 'consumer' | 'commercial' — The product of the card.
    - `card_level` 'aarp' | 'acquiring' | 'advantage' | 'airmiles' | 'atm_only' | 'black' | 'blue' | 'bonus' | 'business' | 'cash' | 'centurion' | 'charge_card' | 'check_card' | 'classic' | 'commerce' | 'commercial' | 'corporate' | 'delta' | 'diamond' | 'distribution' | 'electric_orange' | 'electron' | 'electronic' | 'executive_business' | 'fleet_card' | 'flying_blue' | 'gift' | 'global_payment' | 'gm_card' | 'gold' | 'government' | 'green' | 'gsa' | 'hsa_non_substantiated' | 'hsa_substantiated' | 'icard' | 'infinite' | 'interlink' | 'mastermoney' | 'new_world' | 'optima' | 'ourocard' | 'payment_card' | 'paypass_card' | 'personal' | 'pin_only' | 'platinum' | 'platinum_edge' | 'plus' | 'premier_miles' | 'premium' | 'prepaid' | 'private' | 'professional' | 'propriety' | 'purchasing' | 'q_cash' | 'quantum' | 'rebate' | 'red' | 'reserved' | 'revolving' | 'rewards' | 'salute' | 'sears' | 'signature' | 'small_business' | 'standard' | 'standard_health' | 'unembossed' | 'student' | 'titanium' | 'top_up_card' | 'traditional' | 'travel' | 'ultimate' | 'v_pay' | 'virtual' | 'world' | 'healthcare' | 'prepaid_maestro_travel' | 'maestro_delayed_debit' — The level of the card.
    - `issuer` string — The name of the bank that issued the card.
    - `issuer_country` string — The name of the country the card was issued in.
    - `issuer_country_code` string — The ISO 3166 2-character country code the card was issued in.
    - `eea` boolean — If the card was issued in the EEA.
    - `non_reloadable` boolean — If the card is a non-refundable prepaid card.
  - `customer` Customer
    - `company_id` string, uuid — Unique ID assigned by Acquired.com to the company the customer belongs token.
    - `reference` string — Unique reference assigned by you for the customer when it is created.
    - `first_name` string — The customer's first name.
    - `last_name` string — The customer's last name. **Required for MCC 6012 merchants.**
    - `dob` string, date — The customer's date of birth. **Required for MCC 6012 merchants.**
    - `custom_data` string — Base64 encoded string detailing custom data passed in the request.
    - `billing` object
      - `address` Address
        - `line_1` string — The first line of the customer's address. **Recommended when processing EMV 3DS transactions and for AVS checks.**
        - `line_2` string — The second line of the customer's address.
        - `city` string — The city of the customer's address.
        - `state` string — The 3 letter ISO 3166-2 3-character state code of the customer's address. This should only be sent when processing in the US.
        - `postcode` string — The postcode of the customer's address. **Recommended for MCC 6012 merchants. Required when processing EMV 3DS transactions and for AVS checks.**
        - `country_code` 'al' | 'al' | 'dz' | 'as' | 'ad' | 'ao' | 'ai' | 'aq' | 'ag' | 'ar' | 'am' | 'aw' | 'au' | 'at' | 'az' | 'bs' | 'bh' | 'bd' | 'bb' | 'by' | 'be' | 'bz' | 'bj' | 'bm' | 'bt' | 'bo' | 'ba' | 'bw' | 'br' | 'io' | 'bn' | 'bg' | 'bf' | 'bi' | 'cv' | 'kh' | 'cm' | 'ca' | 'ky' | 'cf' | 'td' | 'cl' | 'cn' | 'co' | 'km' | 'cg' | 'cd' | 'cr' | 'hr' | 'cu' | 'cy' | 'cz' | 'dk' | 'dj' | 'dm' | 'do' | 'ec' | 'eg' | 'sv' | 'gq' | 'er' | 'ee' | 'sz' | 'et' | 'fk' | 'fo' | 'fj' | 'fi' | 'fr' | 'gf' | 'pf' | 'ga' | 'gm' | 'ge' | 'de' | 'gh' | 'gi' | 'gr' | 'gl' | 'gd' | 'gu' | 'gt' | 'gg' | 'gn' | 'gw' | 'gy' | 'ht' | 'hn' | 'hk' | 'hu' | 'is' | 'in' | 'id' | 'ir' | 'iq' | 'ie' | 'im' | 'il' | 'it' | 'jm' | 'jp' | 'je' | 'jo' | 'kz' | 'ke' | 'ki' | 'kp' | 'kr' | 'kw' | 'kg' | 'la' | 'lv' | 'lb' | 'ls' | 'lr' | 'ly' | 'li' | 'lt' | 'lu' | 'mo' | 'mk' | 'mg' | 'mw' | 'my' | 'mv' | 'ml' | 'mt' | 'mh' | 'mq' | 'mr' | 'mu' | 'yt' | 'mx' | 'fm' | 'md' | 'mc' | 'mn' | 'me' | 'ms' | 'ma' | 'mz' | 'mm' | 'na' | 'nr' | 'np' | 'nl' | 'nc' | 'nz' | 'ni' | 'ne' | 'ng' | 'nu' | 'nf' | 'mp' | 'no' | 'om' | 'pk' | 'pw' | 'ps' | 'pa' | 'pg' | 'py' | 'pe' | 'ph' | 'pl' | 'pt' | 'pr' | 'qa' | 'ro' | 'ru' | 'rw' | 're' | 'bl' | 'sh' | 'kn' | 'lc' | 'mf' | 'pm' | 'vc' | 'ws' | 'sm' | 'st' | 'sa' | 'sn' | 'rs' | 'sc' | 'sl' | 'sg' | 'sx' | 'sk' | 'si' | 'sb' | 'so' | 'za' | 'gs' | 'ss' | 'es' | 'lk' | 'sd' | 'sr' | 'se' | 'ch' | 'sx' | 'sy' | 'tw' | 'tj' | 'tz' | 'th' | 'tg' | 'tk' | 'to' | 'tt' | 'tn' | 'tr' | 'tm' | 'tc' | 'tv' | 'ug' | 'ua' | 'ae' | 'gb' | 'us' | 'uy' | 'uz' | 'vu' | 've' | 'vn' | 'vg' | 'vi' | 'wf' | 'eh' | 'ye' | 'zm' | 'zw' — The ISO 3166 2-character code of the customer's address. **Recommended when processing EMV 3DS transactions.**
      - `email` string, email — The customer's email address. **Recommended for processing EMV 3DS transactions.**
      - `phone` Phone
        - `country_code` string — The international dialling code of the customer's phone number.
        - `number` string — The customer's phone number.
    - `shipping` object
      - `address_match` boolean — Set to true if the customer's billing and shipping address are the same to auto populate.
      - `address` Address
        - `line_1` string — The first line of the customer's address. **Recommended when processing EMV 3DS transactions and for AVS checks.**
        - `line_2` string — The second line of the customer's address.
        - `city` string — The city of the customer's address.
        - `state` string — The 3 letter ISO 3166-2 3-character state code of the customer's address. This should only be sent when processing in the US.
        - `postcode` string — The postcode of the customer's address. **Recommended for MCC 6012 merchants. Required when processing EMV 3DS transactions and for AVS checks.**
        - `country_code` 'al' | 'al' | 'dz' | 'as' | 'ad' | 'ao' | 'ai' | 'aq' | 'ag' | 'ar' | 'am' | 'aw' | 'au' | 'at' | 'az' | 'bs' | 'bh' | 'bd' | 'bb' | 'by' | 'be' | 'bz' | 'bj' | 'bm' | 'bt' | 'bo' | 'ba' | 'bw' | 'br' | 'io' | 'bn' | 'bg' | 'bf' | 'bi' | 'cv' | 'kh' | 'cm' | 'ca' | 'ky' | 'cf' | 'td' | 'cl' | 'cn' | 'co' | 'km' | 'cg' | 'cd' | 'cr' | 'hr' | 'cu' | 'cy' | 'cz' | 'dk' | 'dj' | 'dm' | 'do' | 'ec' | 'eg' | 'sv' | 'gq' | 'er' | 'ee' | 'sz' | 'et' | 'fk' | 'fo' | 'fj' | 'fi' | 'fr' | 'gf' | 'pf' | 'ga' | 'gm' | 'ge' | 'de' | 'gh' | 'gi' | 'gr' | 'gl' | 'gd' | 'gu' | 'gt' | 'gg' | 'gn' | 'gw' | 'gy' | 'ht' | 'hn' | 'hk' | 'hu' | 'is' | 'in' | 'id' | 'ir' | 'iq' | 'ie' | 'im' | 'il' | 'it' | 'jm' | 'jp' | 'je' | 'jo' | 'kz' | 'ke' | 'ki' | 'kp' | 'kr' | 'kw' | 'kg' | 'la' | 'lv' | 'lb' | 'ls' | 'lr' | 'ly' | 'li' | 'lt' | 'lu' | 'mo' | 'mk' | 'mg' | 'mw' | 'my' | 'mv' | 'ml' | 'mt' | 'mh' | 'mq' | 'mr' | 'mu' | 'yt' | 'mx' | 'fm' | 'md' | 'mc' | 'mn' | 'me' | 'ms' | 'ma' | 'mz' | 'mm' | 'na' | 'nr' | 'np' | 'nl' | 'nc' | 'nz' | 'ni' | 'ne' | 'ng' | 'nu' | 'nf' | 'mp' | 'no' | 'om' | 'pk' | 'pw' | 'ps' | 'pa' | 'pg' | 'py' | 'pe' | 'ph' | 'pl' | 'pt' | 'pr' | 'qa' | 'ro' | 'ru' | 'rw' | 're' | 'bl' | 'sh' | 'kn' | 'lc' | 'mf' | 'pm' | 'vc' | 'ws' | 'sm' | 'st' | 'sa' | 'sn' | 'rs' | 'sc' | 'sl' | 'sg' | 'sx' | 'sk' | 'si' | 'sb' | 'so' | 'za' | 'gs' | 'ss' | 'es' | 'lk' | 'sd' | 'sr' | 'se' | 'ch' | 'sx' | 'sy' | 'tw' | 'tj' | 'tz' | 'th' | 'tg' | 'tk' | 'to' | 'tt' | 'tn' | 'tr' | 'tm' | 'tc' | 'tv' | 'ug' | 'ua' | 'ae' | 'gb' | 'us' | 'uy' | 'uz' | 'vu' | 've' | 'vn' | 'vg' | 'vi' | 'wf' | 'eh' | 'ye' | 'zm' | 'zw' — The ISO 3166 2-character code of the customer's address. **Recommended when processing EMV 3DS transactions.**
      - `email` string, email — The customer's email address.
      - `phone` Phone
        - `country_code` string — The international dialling code of the customer's phone number.
        - `number` string — The customer's phone number.
    - `created` string, date-time — The date and time at which the customer was created.
    - `last_updated` string, date-time — The date and time the customer record was last updated.
  - `created` string, date-time — The date and time at which the customer was created.
  - `last_updated` string, date-time — The date and time the customer record was last updated.
  - `credential_on_file` 'first' | 'recurring' — Used to identify whether the transaction is the first or a subsequent transaction.
  - `custom_data` string — Base64 encoded string detailing custom data passed in the request.
  - `custom1` string — Send additional data relating to the customer or another internal reference.
  - `custom2` string — Send additional data relating to the customer or another internal reference.
  - `charge_date` string, date — Populate this parameter if you want to set the initial Direct Debit collection for a date in the future, rather than the collection being processed on the next working day.
  - `is_retryable` boolean — Confirms whether the Direct Debit can be retried or not.
  - `detail` object
    - `scheme` 'bacs' — The scheme associated to the transaction.
    - `report` 'ARUDD' — Each of these statuses represent a specific stage or notification within the Bacs system.
    - `reason_code` '0' | '1' | '2' | '3' | '4' | '5' | '6' | '7' | '8' | '9' | 'A' | 'B' — The specific reason code carries details explaining the content of the notification on the report.
    - `reason_description` 'Refer to payer' | 'Instruction cancelled' | 'Payer deceased' | 'Account transferred' | 'Advance notice disputed' | 'No account (OR wrong account type' | 'No instruction' | 'Amount differs' | 'Amount not yet due' | 'Presentation overdue' | 'Service user differs' | 'Account closed' — Provides a description for the relating reason code.

## Other responses

- `400` — Bad Request
- `401` — Unauthorized

---

[API](https://skmtc.net/acquired/apis/acquired-api.md) · [All operations](https://skmtc.net/acquired/apis/acquired-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/acquired/acquired-api/versions/7ae178a046f2/schema)