---
title: "Get transaction for a gateway transaction ID"
method: GET
path: "/v1/transaction/gateway-transaction"
tags: ["Transactions"]
---

# Get transaction for a gateway transaction ID

`GET /v1/transaction/gateway-transaction`

## Request

- Base URL: `http://ledger_url`
- URL: `http://ledger_url/v1/transaction/gateway-transaction`
- Auth: none declared

## Query parameters

- `gateway_transaction_id` string, required
- `payment_provider` string, required

## Response `200`

OK

- TransactionView
  - `agreement_id` string
  - `agreement_payment_type` string
  - `amount` integer
  - `authorisation_mode` 'web' | 'moto_api' | 'agreement' | 'external'
  - `authorisation_summary` AuthorisationSummary
    - `three_d_secure` ThreeDSecure
      - `required` boolean: `true` if payment requires 3D Secure authentication.
      - `version` string
  - `card_details` CardDetails
    - `billing_address` Address
      - `city` string
      - `country` string
      - `county` string
      - `line1` string
      - `line2` string
      - `postcode` string
    - `card_brand` string
    - `card_type` 'CREDIT' | 'DEBIT'
    - `cardholder_name` string
    - `expiry_date` string
    - `first_digits_card_number` string
    - `last_digits_card_number` string
  - `corporate_card_surcharge` integer
  - `created_date` string, date-time
  - `credential_external_id` string
  - `delayed_capture` boolean
  - `description` string
  - `disputed` boolean
  - `email` string
  - `evidence_due_date` string, date-time
  - `exemption` Exemption
    - `outcome` Outcome: Object containing information about the outcome of the 3ds exemption request
      - `result` 'not requested' | 'honoured' | 'rejected' | 'out of scope': Indicating the result if 3ds exemption was requested for the payment.
    - `requested` boolean: Flag indicating whether 3ds exemption was requested for the payment.
    - `type` string: Indicating the type of the 3ds exemption was requested for the payment if applicable.
  - `fee` integer
  - `gateway_account_id` string
  - `gateway_payout_id` string
  - `gateway_transaction_id` string
  - `language` string
  - `live` boolean
  - `metadata` object
  - `moto` boolean
  - `net_amount` integer
  - `parent_transaction_id` string: Parent transaction external ID. Available for refunds
  - `payment_details` TransactionView (recursive)
  - `payment_provider` string
  - `reason` string
  - `reference` string
  - `refund_summary` RefundSummary
    - `amount_available` integer
    - `amount_refunded` integer
    - `amount_submitted` integer
    - `status` string
    - `user_external_id` string
  - `refunded_by` string: External ID of the service user that refunded payment. Only available for refunds
  - `refunded_by_user_email` string: Service user email that refunded the payment. Only available for refunds
  - `return_url` string
  - `service_id` string
  - `settlement_summary` SettlementSummary
    - `settled_date` string
  - `source` 'CARD_API' | 'CARD_PAYMENT_LINK' | 'CARD_AGENT_INITIATED_MOTO' | 'CARD_EXTERNAL_TELEPHONE'
  - `state` ExternalTransactionState
    - `can_retry` boolean, nullable: Only applicable for failed recurring payments. Default value is null
    - `code` string
    - `finished` boolean
    - `message` string
    - `status` string
  - `total_amount` integer
  - `transaction_id` string
  - `transaction_type` 'PAYMENT' | 'REFUND' | 'DISPUTE'
  - `wallet_type` string

## Other responses

- `404`: Not found
- `422`: If payment_provider and/or gateway_transaction_id query parameter is missing

## Changes

- **2026-10-05** `450e568b5b08`: 2 warning, 1 info
  - added the new `AMOUNT_BELOW_MINIMUM_FOR_ADYEN` enum value to the `error_identifier` response property for the response status `422`
  - added the new `AMOUNT_BELOW_MINIMUM_FOR_STRIPE` enum value to the `error_identifier` response property for the response status `422`
  - removed the `AMOUNT_BELOW_MINIMUM` enum value from the `error_identifier` response property for the response status `422`
- **2026-02-03** `10ffeffca918`: 2 breaking
  - for the `query` request parameter `gateway_transaction_id`, the minLength was increased from `0` to `1`
  - for the `query` request parameter `payment_provider`, the minLength was increased from `0` to `1`
- **2026-01-06** `dbe20b36c1c7`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/government-digital-service/apis/ledger-api/changes/v1/transaction/gateway-transaction/get.md)

---

[API](https://skmtc.dev/government-digital-service/apis/ledger-api.md) - [All operations](https://skmtc.dev/government-digital-service/apis/ledger-api/llms.txt) - [OpenAPI document](https://skmtc.dev/government-digital-service/apis/ledger-api/revisions/450e568b5b08?raw)