---
title: "Get events for transaction external ID"
method: GET
path: "/v1/transaction/{transactionExternalId}/event"
tags: ["Transactions"]
---

# Get events for transaction external ID

`GET /v1/transaction/{transactionExternalId}/event`

## Request

- Base URL: `http://ledger_url`
- URL: `http://ledger_url/v1/transaction/{transactionExternalId}/event`
- Auth: none declared

## Path parameters

- `transactionExternalId` string, required

## Query parameters

- `gateway_account_id` string, required
- `include_all_events` boolean
- `status_version` integer

## Response `200`

OK

- TransactionEventResponse
  - `events` TransactionEvent[]
    - `amount` integer
    - `data` object
    - `event_type` string
    - `resource_type` string
    - `state` ExternalTransactionState
      - `can_retry` boolean, nullable: Only applicable for failed recurring payments. Default value is null
      - `code` string
      - `finished` boolean
      - `message` string
      - `status` string
    - `timestamp` string, date-time
  - `transaction_id` string

## Other responses

- `404`: Not found
- `422`: Missing required query parameters

## 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`: 1 breaking
  - for the `query` request parameter `gateway_account_id`, the minLength was increased from `0` to `1`
- **2025-11-25** `45c0496dd043`: 1 info
  - for the `query` request parameter `gateway_account_id`, the minLength was decreased from `1` to `0`
- **2025-04-14** `79baf7d7e1b9`: 1 breaking
  - for the `query` request parameter `gateway_account_id`, the minLength was increased from `0` to `1`
- **2025-01-16** `ef12d134c115`: 1 warning
  - added the new `AMOUNT_BELOW_MINIMUM` enum value to the `error_identifier` response property for the response status `422`

[Operation history](https://skmtc.dev/government-digital-service/apis/ledger-api/changes/v1/transaction/:transactionExternalId/event/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)