Main Resources
Atomic Resources
System
curl --request GET \
--url https://api.wellapp.ai/v1/transactions/{id} \
--header 'Authorization: <authorization>'{
"data": {
"type": "transaction",
"id": "550e8400-e29b-41d4-a716-446655440010",
"attributes": {
"scheme": "sepa",
"external_ids": {
"transaction_id": "TXN_SEPA_20240115_001",
"payment_request_id": "PAY_REQ_001",
"end_to_end_id": "E2E_20240115_ACME_001"
},
"requested_execution_date": "2024-01-15",
"executed_at": "2024-01-15T14:30:00Z",
"booking_date": "2024-01-15",
"value_date": "2024-01-15",
"instructed_amount": {
"currency": "EUR",
"amount": 1250
},
"settlement_amount": {
"currency": "USD",
"amount": 1350.75
},
"foreign_exchange": {
"currency_rate": "1.0806",
"currency_pair": "EURUSD",
"currency_rate_source": "ECB",
"currency_rate_at": "2024-01-15T14:00:00Z"
},
"transaction_type": "transfer",
"status": "completed",
"category_purpose": "CBFF",
"purpose_code": "SALA",
"remittance_information": {
"unstructured": "Salary payment January 2024",
"structured_reference": "RF18539007547034",
"reference_type": "SCOR"
},
"fees": [
{
"type": "transfer_fee",
"amount": 2.5,
"currency": "EUR"
},
{
"type": "exchange_fee",
"amount": 5,
"currency": "EUR"
}
],
"created_at": "2024-01-15T14:30:00Z",
"updated_at": "2024-01-15T14:30:00Z"
},
"relationships": {
"debtor_payment_means": {
"data": {
"type": "payment_means",
"id": "550e8400-e29b-41d4-a716-446655440000"
}
},
"creditor_payment_means": {
"data": {
"type": "payment_means",
"id": "550e8400-e29b-41d4-a716-446655440001"
}
},
"debtor": {
"data": {
"type": "company",
"id": "550e8400-e29b-41d4-a716-446655440002"
}
},
"creditor": {
"data": {
"type": "people",
"id": "550e8400-e29b-41d4-a716-446655440003"
}
},
"documents": {
"data": [
{
"type": "invoice",
"id": "550e8400-e29b-41d4-a716-446655440004"
}
]
},
"created_by": {
"data": {
"type": "people",
"id": "550e8400-e29b-41d4-a716-446655440005"
}
},
"workspaces": {
"data": [
{
"type": "workspace",
"id": "550e8400-e29b-41d4-a716-446655440006"
}
]
}
}
},
"included": [
{
"type": "payment_means",
"id": "550e8400-e29b-41d4-a716-446655440000",
"attributes": {
"type": "account_details",
"status": "active",
"nickname": "Business Primary Account",
"description": "Main SEPA account for outgoing payments"
}
},
{
"type": "payment_means",
"id": "550e8400-e29b-41d4-a716-446655440001",
"attributes": {
"type": "account_details",
"status": "active",
"nickname": "Employee Salary Account",
"description": "Dedicated account for receiving salary payments"
}
},
{
"type": "company",
"id": "550e8400-e29b-41d4-a716-446655440002",
"attributes": {
"name": "Acme Corporation",
"description": "Leading technology solutions provider",
"registration_number": "123456789",
"tax_id": "FR12345678901"
}
},
{
"type": "people",
"id": "550e8400-e29b-41d4-a716-446655440003",
"attributes": {
"first_name": "John",
"last_name": "Doe",
"full_name": "John Doe",
"job_title": "Software Engineer"
}
},
{
"type": "invoice",
"id": "550e8400-e29b-41d4-a716-446655440004",
"attributes": {
"invoice_number": "INV-2024-0115",
"amount": 1250,
"currency": "EUR",
"status": "paid",
"due_date": "2024-01-15"
}
},
{
"type": "people",
"id": "550e8400-e29b-41d4-a716-446655440005",
"attributes": {
"first_name": "Marie",
"last_name": "Martin",
"full_name": "Marie Martin",
"job_title": "Finance Manager"
}
},
{
"type": "workspace",
"id": "550e8400-e29b-41d4-a716-446655440006",
"attributes": {
"name": "Finance Operations",
"description": "Financial operations and treasury management workspace"
}
}
]
}Get Transaction by id
Retrieve a specific financial transaction by its unique identifier. This endpoint supports:
Include functionality: Use the include parameter to get detailed relationship data including payment means, debtor/creditor entities, documents, and workspace information.
Comprehensive data: Returns complete transaction information with all attributes, relationships, foreign exchange details, remittance information, and fee breakdown.
Real-time status: Provides current transaction status and execution details for tracking and reconciliation purposes.
curl --request GET \
--url https://api.wellapp.ai/v1/transactions/{id} \
--header 'Authorization: <authorization>'{
"data": {
"type": "transaction",
"id": "550e8400-e29b-41d4-a716-446655440010",
"attributes": {
"scheme": "sepa",
"external_ids": {
"transaction_id": "TXN_SEPA_20240115_001",
"payment_request_id": "PAY_REQ_001",
"end_to_end_id": "E2E_20240115_ACME_001"
},
"requested_execution_date": "2024-01-15",
"executed_at": "2024-01-15T14:30:00Z",
"booking_date": "2024-01-15",
"value_date": "2024-01-15",
"instructed_amount": {
"currency": "EUR",
"amount": 1250
},
"settlement_amount": {
"currency": "USD",
"amount": 1350.75
},
"foreign_exchange": {
"currency_rate": "1.0806",
"currency_pair": "EURUSD",
"currency_rate_source": "ECB",
"currency_rate_at": "2024-01-15T14:00:00Z"
},
"transaction_type": "transfer",
"status": "completed",
"category_purpose": "CBFF",
"purpose_code": "SALA",
"remittance_information": {
"unstructured": "Salary payment January 2024",
"structured_reference": "RF18539007547034",
"reference_type": "SCOR"
},
"fees": [
{
"type": "transfer_fee",
"amount": 2.5,
"currency": "EUR"
},
{
"type": "exchange_fee",
"amount": 5,
"currency": "EUR"
}
],
"created_at": "2024-01-15T14:30:00Z",
"updated_at": "2024-01-15T14:30:00Z"
},
"relationships": {
"debtor_payment_means": {
"data": {
"type": "payment_means",
"id": "550e8400-e29b-41d4-a716-446655440000"
}
},
"creditor_payment_means": {
"data": {
"type": "payment_means",
"id": "550e8400-e29b-41d4-a716-446655440001"
}
},
"debtor": {
"data": {
"type": "company",
"id": "550e8400-e29b-41d4-a716-446655440002"
}
},
"creditor": {
"data": {
"type": "people",
"id": "550e8400-e29b-41d4-a716-446655440003"
}
},
"documents": {
"data": [
{
"type": "invoice",
"id": "550e8400-e29b-41d4-a716-446655440004"
}
]
},
"created_by": {
"data": {
"type": "people",
"id": "550e8400-e29b-41d4-a716-446655440005"
}
},
"workspaces": {
"data": [
{
"type": "workspace",
"id": "550e8400-e29b-41d4-a716-446655440006"
}
]
}
}
},
"included": [
{
"type": "payment_means",
"id": "550e8400-e29b-41d4-a716-446655440000",
"attributes": {
"type": "account_details",
"status": "active",
"nickname": "Business Primary Account",
"description": "Main SEPA account for outgoing payments"
}
},
{
"type": "payment_means",
"id": "550e8400-e29b-41d4-a716-446655440001",
"attributes": {
"type": "account_details",
"status": "active",
"nickname": "Employee Salary Account",
"description": "Dedicated account for receiving salary payments"
}
},
{
"type": "company",
"id": "550e8400-e29b-41d4-a716-446655440002",
"attributes": {
"name": "Acme Corporation",
"description": "Leading technology solutions provider",
"registration_number": "123456789",
"tax_id": "FR12345678901"
}
},
{
"type": "people",
"id": "550e8400-e29b-41d4-a716-446655440003",
"attributes": {
"first_name": "John",
"last_name": "Doe",
"full_name": "John Doe",
"job_title": "Software Engineer"
}
},
{
"type": "invoice",
"id": "550e8400-e29b-41d4-a716-446655440004",
"attributes": {
"invoice_number": "INV-2024-0115",
"amount": 1250,
"currency": "EUR",
"status": "paid",
"due_date": "2024-01-15"
}
},
{
"type": "people",
"id": "550e8400-e29b-41d4-a716-446655440005",
"attributes": {
"first_name": "Marie",
"last_name": "Martin",
"full_name": "Marie Martin",
"job_title": "Finance Manager"
}
},
{
"type": "workspace",
"id": "550e8400-e29b-41d4-a716-446655440006",
"attributes": {
"name": "Finance Operations",
"description": "Financial operations and treasury management workspace"
}
}
]
}Headers
Bearer token for authentication
Path Parameters
The unique identifier of the transaction to retrieve
Query Parameters
Include related resources in the response. Multiple values can be comma-separated.
Response
Transaction retrieved successfully
Show child attributes
Show child attributes
"transaction"UUID of the created transaction
"550e8400-e29b-41d4-a716-446655440010"
Show child attributes
Show child attributes
Payment scheme used for the transaction
sepa, swift, ach, faster_payments, instant_credit_transfer Show child attributes
Show child attributes
Date when transaction execution was requested
Timestamp when transaction was executed
Date when transaction was booked
Value date of the transaction
Show child attributes
Show child attributes
Exchange rate applied
Currency pair (e.g., EURUSD)
Source of the exchange rate
Timestamp when exchange rate was applied
Type of transaction. See transaction types documentation for complete list.
payment, transfer, deposit, withdrawal, card_payment, direct_debit, refund, fee, interest, other Current status of the transaction
pending, completed, failed, cancelled, rejected ISO 20022 category purpose code
ISO 20022 purpose code
Show child attributes
Show child attributes
Unstructured remittance information
Structured creditor reference
Type of structured reference. See remittance reference types for details.
SCOR, RADM, RPIN, FXDR, DISP, PUOR, SCNR Show child attributes
Show child attributes
Type of fee. See banking transaction fees for details.
transfer_fee, exchange_fee, processing_fee, commission Fee amount
x >= 0ISO 4217 currency code
Timestamp when transaction was created
Timestamp when transaction was last updated
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes
"payment_means"UUID of the debtor payment means (source)
Show child attributes
Show child attributes
Type of payment means. See payment means types for details.
card_details, account_details, wallet_details, cash_details, check_details, crypto_details, other Payment scheme or network. See scheme types for details.
SEPA, SWIFT, ACH, FASTER_PAYMENTS, VISA, MASTERCARD, AMEX, PAYPAL, APPLEPAY, GOOGLEPAY, STRIPE, LOCAL, OTHER Current status of the payment means. See payment means status for details.
active, inactive, pending_verification, suspended, expired, blocked Bank account details for account_details type
Show child attributes
Show child attributes
International Bank Account Number
Bank Identifier Code (SWIFT)
Local account number (alternative to IBAN)
Bank routing number (US ACH)
Currency code (ISO 4217)
Additional bank information
Show child attributes
Show child attributes
Name of the bank
Bank code or identifier
Bank branch name
Bank branch code
Credit/debit card details for card_details type
Show child attributes
Show child attributes
Masked Primary Account Number (PCI DSS compliant)
Card brand
visa, mastercard, amex, discover, diners, jcb, unionpay, other Type of card
credit, debit, prepaid, charge Card expiry month
Card expiry year
Name as printed on card
Digital wallet details for wallet_details type
Show child attributes
Show child attributes
Digital wallet provider
paypal, applepay, googlepay, stripe, square, venmo, cashapp, other Wallet identifier (email, phone, etc.)
Type of wallet account
personal, business, merchant Compliance and verification status
Show child attributes
Show child attributes
Know Your Customer verification status
pending, in_progress, completed, failed, not_required Anti-Money Laundering check status
pending, in_progress, cleared, flagged, not_required Sanctions screening status
pending, passed, failed, not_required Last compliance check timestamp
System metadata
User-friendly name for the payment means
Additional description of the payment means
Tags for categorization
Creation timestamp
Last update timestamp
Show child attributes
Show child attributes
Show child attributes
Show child attributes
"payment_means"UUID of the creditor payment means (destination)
Show child attributes
Show child attributes
Type of payment means. See payment means types for details.
card_details, account_details, wallet_details, cash_details, check_details, crypto_details, other Payment scheme or network. See scheme types for details.
SEPA, SWIFT, ACH, FASTER_PAYMENTS, VISA, MASTERCARD, AMEX, PAYPAL, APPLEPAY, GOOGLEPAY, STRIPE, LOCAL, OTHER Current status of the payment means. See payment means status for details.
active, inactive, pending_verification, suspended, expired, blocked Bank account details for account_details type
Show child attributes
Show child attributes
International Bank Account Number
Bank Identifier Code (SWIFT)
Local account number (alternative to IBAN)
Bank routing number (US ACH)
Currency code (ISO 4217)
Additional bank information
Show child attributes
Show child attributes
Name of the bank
Bank code or identifier
Bank branch name
Bank branch code
Credit/debit card details for card_details type
Show child attributes
Show child attributes
Masked Primary Account Number (PCI DSS compliant)
Card brand
visa, mastercard, amex, discover, diners, jcb, unionpay, other Type of card
credit, debit, prepaid, charge Card expiry month
Card expiry year
Name as printed on card
Digital wallet details for wallet_details type
Show child attributes
Show child attributes
Digital wallet provider
paypal, applepay, googlepay, stripe, square, venmo, cashapp, other Wallet identifier (email, phone, etc.)
Type of wallet account
personal, business, merchant Compliance and verification status
Show child attributes
Show child attributes
Know Your Customer verification status
pending, in_progress, completed, failed, not_required Anti-Money Laundering check status
pending, in_progress, cleared, flagged, not_required Sanctions screening status
pending, passed, failed, not_required Last compliance check timestamp
System metadata
User-friendly name for the payment means
Additional description of the payment means
Tags for categorization
Creation timestamp
Last update timestamp
Show child attributes
Show child attributes
- Option 1
- Option 2
Show child attributes
Show child attributes
"company"Show child attributes
Show child attributes
The domain url from the website or email address of the company. Used as unique identifier in some cases.
500Show child attributes
Show child attributes
Legal entity structure type.
Official company registration number.
Name of the official registration body.
Country of the registry authority. (string (ISO 3166-1 alpha-2))
UUID of the workspace associated with this company
Show child attributes
Show child attributes
- Option 1
- Option 2
Show child attributes
Show child attributes
"company"Show child attributes
Show child attributes
The domain url from the website or email address of the company. Used as unique identifier in some cases.
500Show child attributes
Show child attributes
Legal entity structure type.
Official company registration number.
Name of the official registration body.
Country of the registry authority. (string (ISO 3166-1 alpha-2))
UUID of the workspace associated with this company
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Type of document
document, invoice UUID of the document (receipts, confirmations, invoices)
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes
"people"UUID of the user who created the transaction record
Show child attributes
Show child attributes
The person's first name
The person's last name
The person's full name (typically first_name + last_name)
Timestamp when the person was created
Timestamp when the person was last updated
Show child attributes
Show child attributes
Show child attributes
Show child attributes
"workspace"UUID of the workspace associated with this transaction
Show child attributes
Show child attributes
Workspace name
Workspace description
external workspace id
Color of the avatar
Timestamp when the workspace was created
Timestamp when the workspace was last updated