Step 2: View single transaction details

Get all the details about a single transaction that has occurred on your account in standard JSON payload format. Note that in sandbox, orders are excluded from the results.

There are a number of additional parameters available for you to filter your results. For more information, see the API reference.

This endpoint requires a type and id in the path. The type determines what kind of transaction you’re looking up, and the id format varies accordingly:

Type	ID format	Example
`transaction`	UUID (the transaction’s `id`)	`19bbf64b-ddfb-48ee-b125-66ed4455d534`
`payment`	Integer (the payment’s `id`)	`123456`
`order`	String (the `originOrderId`)	`F6VOXCZ1AMND`
`boxTransaction`	UUID (the `transactionBox.id`)	`992e9652-d313-4ea7-aa93-b96b247627c2`

In this example, we’re retrieving a payment transaction by its ID. Replace {accountId} with your account ID and YOUR_API_KEY_HERE with your API key.

curl -i -X GET \
  'https://api-sandbox.equalsmoney.com/v2/activity/payment/123456?accountId=F12345' \
  -H 'Authorization: ApiKey YOUR_API_KEY_HERE'

curl -i -X GET \
  'https://api.equalsmoney.com/v2/activity/payment/123456?accountId=F12345' \
  -H 'Authorization: ApiKey YOUR_API_KEY_HERE'

If your request is successful, you’ll receive a 200 response containing a single transaction object.

Sample response (payment)

{
  "budget": "companyBalance",
  "resourceType": "payment",
  "id": 123456,
  "orderId": 654321,
  "userId": "4bf13dc8-d128-4521-99b8-4002b8987499",
  "originId": "0684fc07-4abc-46de-b664-da45ef3c4072",
  "originOrderId": "F6VOXCZ1AMND",
  "companyId": "F12345",
  "status": "complete",
  "transactionGroupId": null,
  "isMultiBeneficiary": false,
  "remitterName": null,
  "beneficiaryId": "7l2nks3eh",
  "beneficiaryName": "William Walker",
  "beneficiaryAddress": "68 Upper Thames St",
  "beneficiaryAccountNumber": "12345678",
  "beneficiarySortCode": "123456",
  "beneficiaryIban": "",
  "beneficiaryBankCode": "",
  "beneficiaryCountryCode": "GB",
  "beneficiaryBankAddress": "UPPER THAMES STREET, 68 VINTNERS PLACE FAIRFX FLOOR 3 LONDON EC4V 3BJ",
  "beneficiaryRoutingInfo": "Payment will be routed from Bank of England and then through Lloyds bank",
  "reference": "Invoice 3468 payment",
  "amount": 99.99,
  "currency": "GBP",
  "buyCurrency": "GBP",
  "sellCurrency": "GBP",
  "settlementAmountWithoutFee": 99.99,
  "settlementAmount": 99.99,
  "settlementFee": 0,
  "customerRate": 1,
  "customerInverseRate": 1,
  "uniqueId": "8233f929-94d3-4390-8d27-da92b733cafb",
  "confirmationKey": "F12345/pdf/F12345-F6VOXCZ1AMND.pdf",
  "type": "payment",
  "budgetId": "63f4b801-70d6-4bba-b3f3-7b9acd051633",
  "budgetName": "Account balance",
  "createdAt": "2022-11-14T10:55:28.000Z",
  "updatedAt": "2022-11-14T10:55:30.000Z",
  "order": {
    "id": 654321,
    "orderSource": "legacy",
    "companyId": "F12345",
    "originId": "F6VOXCZ1AMND",
    "parentOriginId": null,
    "userId": "d4fd55fe-836d-48d2-8d49-e5629bd508a6",
    "userName": "John Doe",
    "status": "complete",
    "type": "payment",
    "lastSourceEventDatetime": null,
    "createdAt": "2022-11-14T10:55:28.000Z",
    "updatedAt": "2022-11-14T10:55:30.000Z",
    "settlementDate": null,
    "events": [
      {
        "id": "beec0eb3-3e11-44a4-86de-65404510038a",
        "eventId": "4c191b59-685b-454b-bad7-e832505ee51c",
        "orderCreatedAt": "2022-11-14T10:55:28.000Z",
        "eventType": 0,
        "orderId": 654321,
        "title": "Order created",
        "description": "Payment to William Walker created",
        "createdAt": "2022-11-14T10:55:28.000Z",
        "referencedOriginOrderId": null
      }
    ]
  },
  "transactionBoxes": []
}

The response structure varies depending on the transaction type. For card transactions (resourceType: "card"), the response includes cardTransaction and merchant objects. For box transactions (resourceType: "box"), the response includes transaction box details.

Example: Get a transaction by UUID

You can also look up a transaction using the transaction type with a UUID. This is useful when you have a transaction id from the list endpoint and want to get its full details.

curl -i -X GET \
  'https://api.equalsmoney.com/v2/activity/transaction/19bbf64b-ddfb-48ee-b125-66ed4455d534?accountId=F12345' \
  -H 'Authorization: ApiKey YOUR_API_KEY_HERE'

When using type=transaction, the API automatically determines the transaction subtype (card, credit/debit, or BVNK) based on the transaction’s internal type, and returns the appropriate response structure. For full details on all response structures, see the View single transaction guide.

Get payment files

For SWIFT and CHAPS payments, you can also download the proof of payment. This is the original bank message for the payment, provided as either an MT103 or an ISO 20022 pacs.008 document. To include it in the response, add paymentFiles to the include query parameter.

curl -i -X GET \
  'https://api-sandbox.equalsmoney.com/v2/activity/payment/123456?accountId=F12345&include=paymentFiles' \
  -H 'Authorization: ApiKey YOUR_API_KEY_HERE'

curl -i -X GET \
  'https://api.equalsmoney.com/v2/activity/payment/123456?accountId=F12345&include=paymentFiles' \
  -H 'Authorization: ApiKey YOUR_API_KEY_HERE'

When a proof is available, the response includes a paymentFiles array on the transaction. Each item describes one downloadable file.

Example response for paymentFiles

"paymentFiles": [
  {
    "fileType": "MT103",
    "url": "https://files.equalsmoney.com/payment-information/eb6305c8.xml?X-Amz-Signature=...",
    "expiresAt": "2024-01-30T11:17:15.000Z"
  }
]

fileType tells you the document format (MT103, PACS008, PAIN001, or PDF).
url is a secure link to download the file.
expiresAt is the date and time when that link stops working.

Payment files are available for SWIFT and CHAPS payments only, and cover both outbound payments (type=payment) and inbound credits (type=boxTransaction). The download link expires after a short time, so retrieve the file promptly. If the link has expired, request the transaction again to get a new one. If no proof is available yet, paymentFiles will be empty. For full details, see the View single transaction guide.

​Step 2: View single transaction details

​Example: Get a transaction by UUID

​Get payment files

Step 2: View single transaction details

Example: Get a transaction by UUID

Get payment files