Get transaction details

Authenticated owners get the full UX (status auto-sync, document download links, crypto→internal repair). Unauthenticated callers must pass ?key= with a share key issued by POST /transactions/{id}/share. Without auth and without a valid key the endpoint returns 401.

GET /api/v1/transactions/{transaction_id}/details

Get transaction details

cURL

curl --request GET \
  --url https://api.hevn.finance/api/v1/transactions/{transaction_id}/details \
  --header 'Authorization: Bearer <token>'

200

{
  "onchainTransactionId": "<string>",
  "type": "<string>",
  "time": "2023-11-07T05:31:56Z",
  "isIncome": true,
  "from": {
    "currency": "<string>",
    "amount": 123,
    "usdRate": 123,
    "source": "<string>"
  },
  "to": {
    "currency": "<string>",
    "amount": 123,
    "usdRate": 123,
    "source": "<string>"
  },
  "fee": {
    "currency": "<string>",
    "amount": 123,
    "usdRate": 123,
    "source": "<string>"
  },
  "walletFrom": {
    "address": "<string>",
    "chainId": "<string>"
  },
  "walletTo": {
    "address": "<string>",
    "chainId": "<string>"
  },
  "ibanFrom": {
    "bankName": "<string>",
    "ibanNumber": "<string>",
    "beneficiaryName": "<string>",
    "bankAddress": "<string>",
    "currency": "<string>",
    "accountHolderFirstName": "<string>",
    "accountHolderLastName": "<string>",
    "accountHolderBusinessName": "<string>",
    "accountHolderAddress": {
      "streetAddress": "<string>",
      "addressLine2": "<string>",
      "city": "<string>",
      "state": "<string>",
      "zip": "<string>"
    },
    "paymentReference": "<string>",
    "accountType": "sepa",
    "bic": "<string>"
  },
  "ibanTo": {
    "bankName": "<string>",
    "ibanNumber": "<string>",
    "beneficiaryName": "<string>",
    "bankAddress": "<string>",
    "currency": "<string>",
    "accountHolderFirstName": "<string>",
    "accountHolderLastName": "<string>",
    "accountHolderBusinessName": "<string>",
    "accountHolderAddress": {
      "streetAddress": "<string>",
      "addressLine2": "<string>",
      "city": "<string>",
      "state": "<string>",
      "zip": "<string>"
    },
    "paymentReference": "<string>",
    "accountType": "sepa",
    "bic": "<string>"
  },
  "txHash": "<string>",
  "originChainId": "<string>",
  "destinationChainId": "<string>",
  "explorerUrl": "<string>",
  "description": "<string>",
  "card": {
    "name": "<string>",
    "label": "<string>",
    "merchant": "<string>",
    "merchantIcon": "<string>",
    "category": "<string>"
  },
  "contact": {
    "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "name": "<string>",
    "email": "<string>",
    "address": "<string>"
  },
  "userFrom": {
    "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "email": "<string>",
    "name": "<string>",
    "avatarUrl": "<string>",
    "address": "<string>"
  },
  "userTo": {
    "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "email": "<string>",
    "name": "<string>",
    "avatarUrl": "<string>",
    "address": "<string>"
  },
  "approvedBy": {
    "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "email": "<string>",
    "name": "<string>",
    "avatarUrl": "<string>",
    "address": "<string>"
  },
  "providerTrId": "<string>",
  "invoice": {
    "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "name": "<string>",
    "documentName": "<string>",
    "documentLink": "<string>",
    "dueDate": "2023-12-25",
    "items": [
      {}
    ],
    "invoiceLink": "<string>",
    "issueDate": "2023-12-25",
    "currency": "<string>",
    "discount": "<string>"
  },
  "attachments": [
    {
      "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "createdAt": "2023-11-07T05:31:56Z",
      "name": "<string>",
      "downloadLink": "<string>"
    }
  ]
}

Authorizations

Authorization · string · header · default: Bearer <token> · required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Headers

x-api-key · string | null

Path Parameters

transaction_id · string · required

Query Parameters

key · string | null

Response

200

application/json

Successful Response

Detailed transaction response with wallet/IBAN info.

onchainTransactionId · string · required

type · string · required

status · enum<string> · required

Unified transaction status.

Available options: pending, success, failed, refunded

time · string<date-time> · required

isIncome · boolean · required

from · TransactionAmountDetail · object · required

Currency / amount / rate leg of a transaction.

Show child attributes

to · TransactionAmountDetail · object

Currency / amount / rate leg of a transaction.

Show child attributes

fee · TransactionAmountDetail · object

Currency / amount / rate leg of a transaction.

Show child attributes

walletFrom · TransactionWalletDetail · object

Wallet details for transaction list/detail views.

Show child attributes

walletTo · TransactionWalletDetail · object

Wallet details for transaction list/detail views.

Show child attributes

ibanFrom · IBANAccountDetails · object

IBAN (SEPA) external account.

IBANAccountDetails

USExternalAccountDetails

SwiftAccountDetails

Show child attributes

ibanTo · IBANAccountDetails · object

IBAN (SEPA) external account.

IBANAccountDetails

USExternalAccountDetails

SwiftAccountDetails

Show child attributes

txHash · string | null

originChainId · string | null

destinationChainId · string | null

explorerUrl · string | null

description · string | null

card · TransactionCardDetail · object

Card and merchant info for card transactions.

Show child attributes

contact · TransactionContactDetail · object

Contact details for transaction detail view.

Show child attributes

userFrom · UserPreview · object

Lightweight user preview (for transaction participants, etc.).

Show child attributes

userTo · UserPreview · object

Lightweight user preview (for transaction participants, etc.).

Show child attributes

approvedBy · UserPreview · object

Lightweight user preview (for transaction participants, etc.).

UserPreview

ApiKeyListResponse

Show child attributes

providerTrId · string | null

invoice · TransactionInvoiceDetail · object

Invoice info embedded in transaction details.

Show child attributes

attachments · TransactionAttachment · object[]

Show child attributes