Accounts APITransactions

Get transaction details

GET
/transactions/{transactionId}

Authorization

BearerAuth
headerAuthorizationBearer <token>

Path Parameters

transactionId*string

Unique UUID of the transaction.

Formatuuid

Header Parameters

X-Volt-Api-Version*1

Version of the API used. Currently, version 1 is the only version.

Value in1

Response Body

Full details of the specified transaction.

application/json
  1. response
id?string

Unique UUID of the transaction generated by Volt.

Formatuuid
status?TransactionStatusEnum
Value in"CREATED""PROCESSING""COMPLETED""REJECTED"
failure?

Details regarding why a transaction was not successful.

operation?TransactionOperationEnum
Value in"OUTGOING""INCOMING"
type?TransactionTypeEnum
Value in"PAYOUT""SETTLEMENT""REFUND""INTERNAL""GATEWAY_PAYMENT""MANUAL_CREDIT""TOP_UP""BOUNCE_BACK""REVERSAL"
subtype?TransactionSubTypeEnum
Value in"OPEN_LOOP""CLOSE_LOOP""VERIFIED""PARTIAL""FULL"
createdAt?string

The timestamp when the transaction was initially created (ISO 8601).

Formatdate-time
updatedAt?string

The timestamp of the last status update (ISO 8601).

Formatdate-time
amount?integer

The total value of the transaction represented in minor units (e.g. 100 for 1.00 EUR). Must be a positive integer.

Formatint64
Range1 <= value
currency?CurrencyCode

Three-letter ISO 4217 currency code.

Match^[A-Z]{3}$
paymentReference?PaymentReference

The reconciliation reference that appears on the bank statement. This is crucial for matching the transaction with external banking records. Maximum length: 35 (EU) or 18 (UK).

Match^(?=.*\S)[a-zA-Z0-9\/\-?:().,'+ ]*$
Length1 <= length <= 35
internalReference?|

Unique identifier of the transaction in the partner's system. Useful for automated reconciliation and logging.

Match^[a-zA-Z0-9!@#$%^&*()_+={\[\]};:?|\-]*$
Lengthlength <= 100
paymentRail?|

The specific infrastructure used to move the funds (e.g. SEPA_INSTANT, FPS).

beneficiary?

The recipient of the funds.

sender?
initiatedBy?
gatewayPaymentId?|

UUID of the linked gateway payment, if transaction was matched with a Volt Connect payment.

Formatuuid
sourceTransactionId?|

UUID of the source transaction (e.g. the original transaction being refunded, reversed, or returned).

Formatuuid
decisions?array<>
verifications?

Group of verification results.

_links?
curl -X GET "https://example.com/transactions/497f6eca-6276-4993-bfeb-53cbbbba6f08" \  -H "X-Volt-Api-Version: 1"

{  "id": "efffed42-40f7-4bd2-840d-908aae9a33ad",  "status": "COMPLETED",  "failure": null,  "operation": "OUTGOING",  "type": "PAYOUT",  "subtype": "OPEN_LOOP",  "createdAt": "2019-08-24T14:15:22Z",  "updatedAt": "2019-08-25T14:15:22Z",  "amount": 500,  "currency": "EUR",  "paymentReference": "Payout123456",  "internalReference": "H35X48Y4FWOD6G3S",  "paymentRail": "SEPA",  "beneficiary": {    "name": "John Doe",    "country": "GB",    "email": "email@email.com",    "accountIdentifiers": {      "iban": "DE07500105176551562526"    },    "address": {      "addressLine1": "123, Main Street",      "addressLine2": "",      "city": "London",      "postalCode": "12332",      "country": "GB"    }  },  "sender": {    "name": "Account Holding",    "customerId": "efffed42-40f7-4bd2-840d-908aae9a33ad",    "accountId": "efffed42-40f7-4bd2-840d-908aae9a33ad",    "accountIdentifiers": {      "iban": "DE07500105176551562526",      "swiftBic": "123456"    }  },  "initiatedBy": {    "user": {      "id": "efffed42-40f7-4bd2-840d-908aae9a33ad",      "name": "Robert Robertson",      "type": "USER"    }  },  "decisions": [    {      "user": {        "id": "efffed42-40f7-4bd2-840d-908aae9a33ad",        "name": "Robert Robertson",        "type": "USER"      },      "type": "APPROVED",      "createdAt": "2019-08-24T14:15:22Z"    }  ],  "_links": {    "self": {      "href": "https://accounts.volt.io/transactions/efffed42-40f7-4bd2-840d-908aae9a33ad",      "method": "GET"    }  }}