Update Transaction

Headers

Authorization

string

required

Bearer token for authentication

Path Parameters

string<uuid>

required

The unique identifier of the transaction to update

Body

application/json

data

object

required

Show child attributes

data.type

string

required

Resource type identifier

Allowed value: "transaction"

data.attributes

object

Partial update attributes for transaction. All fields are optional for PATCH operations.

Show child attributes

data.attributes.status

enum<string>

Updated transaction status. See transaction status for details.

Available options:

pending,

processing,

authorized,

completed,

failed,

rejected,

cancelled,

reversed

data.attributes.executed_at

string<date-time>

Updated execution timestamp in ISO 8601 format

data.attributes.booking_date

string<date>

Updated booking date in YYYY-MM-DD format

data.attributes.value_date

string<date>

Updated value date in YYYY-MM-DD format

data.attributes.settlement_amount

object

Show child attributes

data.attributes.settlement_amount.currency

string

Updated settlement currency (ISO 4217 code)

data.attributes.settlement_amount.amount

number

Updated settlement amount

Must be a multiple of 0.01

data.attributes.foreign_exchange

object

Show child attributes

data.attributes.foreign_exchange.currency_rate

string

Updated exchange rate as string for precision

data.attributes.foreign_exchange.currency_rate_source

string

Updated source of exchange rate (e.g., ECB, Fed, manual)

data.attributes.foreign_exchange.currency_pair

string

Updated currency pair (e.g., EURUSD)

data.attributes.fees

object[]

Show child attributes

data.attributes.fees.type

enum<string>

Updated fee type

Available options:

commission,

service,

processing,

transfer,

atm,

overdraft,

monthly,

card,

other

data.attributes.fees.currency

string

Updated fee currency

data.attributes.fees.amount

number

Updated fee amount

Must be a multiple of 0.01

data.attributes.fees.description

string

Updated fee description

data.attributes.remittance_information

object

Show child attributes

data.attributes.remittance_information.unstructured

string[]

Updated unstructured remittance information

data.attributes.remittance_information.structured

object

Show child attributes

data.attributes.remittance_information.structured.reference

string

Updated payment reference

data.attributes.remittance_information.structured.reference_type

enum<string>

Updated reference type

Available options:

SCOR,

CBFF,

REMI,

RADM

data.attributes.remittance_information.structured.reference_issuer

string

Updated reference issuer

data.attributes.remittance_information.structured.creditor_reference_information

object

Show child attributes

data.attributes.remittance_information.structured.creditor_reference_information.reference

string

Updated creditor reference

data.attributes.remittance_information.structured.creditor_reference_information.reference_type

string

Updated creditor reference type

data.attributes.remittance_information.structured.creditor_reference_information.reference_issuer

string

Updated creditor reference issuer

data.attributes.external_ids

object

Updated external system identifiers

Show child attributes

data.attributes.external_ids.{key}

string

data.attributes.metadata

object

Updated additional metadata

data.relationships

object

Show child attributes

data.relationships.debtor_payment_means

object

required

Show child attributes

data.relationships.debtor_payment_means.data

object

required

Show child attributes

data.relationships.debtor_payment_means.data.type

string

required

Allowed value: "payment_means"

data.relationships.debtor_payment_means.data.id

string<uuid>

required

UUID of an existing payment means or temp-id that references a payment means defined in the included array (source account)

data.relationships.creditor_payment_means

object

required

Show child attributes

data.relationships.creditor_payment_means.data

object

required

Show child attributes

data.relationships.creditor_payment_means.data.type

string

required

Allowed value: "payment_means"

data.relationships.creditor_payment_means.data.id

string<uuid>

required

UUID of an existing payment means or temp-id that references a payment means defined in the included array (destination account)

data.relationships.debtor

object

Show child attributes

data.relationships.debtor.data

object

Show child attributes

data.relationships.debtor.data.type

enum<string>

required

Type of debtor entity

Available options:

company,

people

data.relationships.debtor.data.id

string<uuid>

required

UUID of an existing company or person, or temp-id that references an entity defined in the included array (entity that initiated the payment)

data.relationships.creditor

object

Show child attributes

data.relationships.creditor.data

object

Show child attributes

data.relationships.creditor.data.type

enum<string>

required

Type of creditor entity

Available options:

company,

people

data.relationships.creditor.data.id

string<uuid>

required

UUID of an existing company or person, or temp-id that references an entity defined in the included array (entity that received the payment)

data.relationships.documents

object

Show child attributes

data.relationships.documents.data

object[]

Show child attributes

data.relationships.documents.data.type

enum<string>

required

Type of document

Available options:

document,

invoice

data.relationships.documents.data.id

string<uuid>

required

UUID of an existing document or invoice, or temp-id that references a document defined in the included array)

data.relationships.created_by

object

Show child attributes

data.relationships.created_by.data

object

Show child attributes

data.relationships.created_by.data.type

string

required

Allowed value: "people"

data.relationships.created_by.data.id

string<uuid>

required

UUID of an existing person or temp-id that references a person defined in the included array (user who created the transaction record)

data.relationships.workspaces

object

Show child attributes

data.relationships.workspaces.data

object[]

Show child attributes

data.relationships.workspaces.data.type

string

required

Allowed value: "workspace"

data.relationships.workspaces.data.id

string<uuid>

required

UUID of an existing workspace or temp-id that references a workspace defined in the included array

data.included

object

Show child attributes

data.included.debtor_payment_means

object

Show child attributes

data.included.debtor_payment_means.type

string

Allowed value: "payment_means"

data.included.debtor_payment_means.id

string

Temp-id that references a payment means in the relationships

data.included.debtor_payment_means.attributes

object

Show child attributes

data.included.debtor_payment_means.attributes.type

enum<string>

required

Type of payment means. See payment means types for details.

Available options:

card_details,

account_details,

wallet_details,

...

data.included.debtor_payment_means.attributes.scheme

enum<string>

Payment scheme or network. See scheme types for details.

Available options:

SEPA,

SWIFT,

ACH,

...

data.included.debtor_payment_means.attributes.status

enum<string>

Current status of the payment means. See payment means status for details.

Available options:

active,

inactive,

pending_verification,

suspended,

expired,

blocked

data.included.debtor_payment_means.attributes.account_details

object

Bank account details for account_details type

Show child attributes

data.included.debtor_payment_means.attributes.account_details.iban

string

International Bank Account Number

data.included.debtor_payment_means.attributes.account_details.bic

string

Bank Identifier Code (SWIFT)

data.included.debtor_payment_means.attributes.account_details.sort_code

string

Bank sort code (UK)

data.included.debtor_payment_means.attributes.account_details.account_number

string

Local account number (alternative to IBAN)

data.included.debtor_payment_means.attributes.account_details.routing_number

string

Bank routing number (US ACH)

data.included.debtor_payment_means.attributes.account_details.currency

string

Currency code (ISO 4217)

data.included.debtor_payment_means.attributes.bank_details

object

Additional bank information

Show child attributes

data.included.debtor_payment_means.attributes.bank_details.bank_name

string

Name of the bank

data.included.debtor_payment_means.attributes.bank_details.bank_code

string

Bank code or identifier

data.included.debtor_payment_means.attributes.bank_details.branch_name

string

Bank branch name

data.included.debtor_payment_means.attributes.bank_details.branch_code

string

Bank branch code

data.included.debtor_payment_means.attributes.card_details

object

Credit/debit card details for card_details type

Show child attributes

data.included.debtor_payment_means.attributes.card_details.masked_pan

string

Masked Primary Account Number (PCI DSS compliant)

data.included.debtor_payment_means.attributes.card_details.brand

enum<string>

Card brand

Available options:

visa,

mastercard,

amex,

discover,

diners,

jcb,

unionpay,

other

data.included.debtor_payment_means.attributes.card_details.card_type

enum<string>

Type of card

Available options:

credit,

debit,

prepaid,

charge

data.included.debtor_payment_means.attributes.card_details.expiry_month

integer

Card expiry month

Required range: 1 <= x <= 12

data.included.debtor_payment_means.attributes.card_details.expiry_year

integer

Card expiry year

Required range: x >= 2024

data.included.debtor_payment_means.attributes.card_details.cardholder_name

string

Name as printed on card

data.included.debtor_payment_means.attributes.digital_wallet

object

Digital wallet details for wallet_details type

Show child attributes

data.included.debtor_payment_means.attributes.digital_wallet.provider

enum<string>

Digital wallet provider

Available options:

paypal,

applepay,

googlepay,

stripe,

square,

venmo,

cashapp,

other

data.included.debtor_payment_means.attributes.digital_wallet.wallet_id

string

Wallet identifier (email, phone, etc.)

data.included.debtor_payment_means.attributes.digital_wallet.wallet_type

enum<string>

Type of wallet account

Available options:

personal,

business,

merchant

data.included.debtor_payment_means.attributes.compliance

object

Compliance and verification status

Show child attributes

data.included.debtor_payment_means.attributes.compliance.kyc_status

enum<string>

Know Your Customer verification status

Available options:

pending,

in_progress,

completed,

failed,

not_required

data.included.debtor_payment_means.attributes.compliance.aml_status

enum<string>

Anti-Money Laundering check status

Available options:

pending,

in_progress,

cleared,

flagged,

not_required

data.included.debtor_payment_means.attributes.nickname

string

User-friendly name for the payment means

Maximum string length: 100

data.included.debtor_payment_means.attributes.description

string

Additional description of the payment means

Maximum string length: 500

data.included.debtor_payment_means.attributes.tags

string[]

Tags for categorization

data.included.creditor_payment_means

object

Show child attributes

data.included.creditor_payment_means.type

string

Allowed value: "payment_mean"

data.included.creditor_payment_means.id

string

Temp-id that references a creditor payment means in the relationships

data.included.creditor_payment_means.attributes

object

Show child attributes

data.included.creditor_payment_means.attributes.type

enum<string>

required

Type of payment means. See payment means types for details.

Available options:

card_details,

account_details,

wallet_details,

...

data.included.creditor_payment_means.attributes.scheme

enum<string>

Payment scheme or network. See scheme types for details.

Available options:

SEPA,

SWIFT,

ACH,

...

data.included.creditor_payment_means.attributes.status

enum<string>

Current status of the payment means. See payment means status for details.

Available options:

active,

inactive,

pending_verification,

suspended,

expired,

blocked

data.included.creditor_payment_means.attributes.account_details

object

Bank account details for account_details type

Show child attributes

data.included.creditor_payment_means.attributes.account_details.iban

string

International Bank Account Number

data.included.creditor_payment_means.attributes.account_details.bic

string

Bank Identifier Code (SWIFT)

data.included.creditor_payment_means.attributes.account_details.sort_code

string

Bank sort code (UK)

data.included.creditor_payment_means.attributes.account_details.account_number

string

Local account number (alternative to IBAN)

data.included.creditor_payment_means.attributes.account_details.routing_number

string

Bank routing number (US ACH)

data.included.creditor_payment_means.attributes.account_details.currency

string

Currency code (ISO 4217)

data.included.creditor_payment_means.attributes.bank_details

object

Additional bank information

Show child attributes

data.included.creditor_payment_means.attributes.bank_details.bank_name

string

Name of the bank

data.included.creditor_payment_means.attributes.bank_details.bank_code

string

Bank code or identifier

data.included.creditor_payment_means.attributes.bank_details.branch_name

string

Bank branch name

data.included.creditor_payment_means.attributes.bank_details.branch_code

string

Bank branch code

data.included.creditor_payment_means.attributes.card_details

object

Credit/debit card details for card_details type

Show child attributes

data.included.creditor_payment_means.attributes.card_details.masked_pan

string

Masked Primary Account Number (PCI DSS compliant)

data.included.creditor_payment_means.attributes.card_details.brand

enum<string>

Card brand

Available options:

visa,

mastercard,

amex,

discover,

diners,

jcb,

unionpay,

other

data.included.creditor_payment_means.attributes.card_details.card_type

enum<string>

Type of card

Available options:

credit,

debit,

prepaid,

charge

data.included.creditor_payment_means.attributes.card_details.expiry_month

integer

Card expiry month

Required range: 1 <= x <= 12

data.included.creditor_payment_means.attributes.card_details.expiry_year

integer

Card expiry year

Required range: x >= 2024

data.included.creditor_payment_means.attributes.card_details.cardholder_name

string

Name as printed on card

data.included.creditor_payment_means.attributes.digital_wallet

object

Digital wallet details for wallet_details type

Show child attributes

data.included.creditor_payment_means.attributes.digital_wallet.provider

enum<string>

Digital wallet provider

Available options:

paypal,

applepay,

googlepay,

stripe,

square,

venmo,

cashapp,

other

data.included.creditor_payment_means.attributes.digital_wallet.wallet_id

string

Wallet identifier (email, phone, etc.)

data.included.creditor_payment_means.attributes.digital_wallet.wallet_type

enum<string>

Type of wallet account

Available options:

personal,

business,

merchant

data.included.creditor_payment_means.attributes.compliance

object

Compliance and verification status

Show child attributes

data.included.creditor_payment_means.attributes.compliance.kyc_status

enum<string>

Know Your Customer verification status

Available options:

pending,

in_progress,

completed,

failed,

not_required

data.included.creditor_payment_means.attributes.compliance.aml_status

enum<string>

Anti-Money Laundering check status

Available options:

pending,

in_progress,

cleared,

flagged,

not_required

data.included.creditor_payment_means.attributes.nickname

string

User-friendly name for the payment means

Maximum string length: 100

data.included.creditor_payment_means.attributes.description

string

Additional description of the payment means

Maximum string length: 500

data.included.creditor_payment_means.attributes.tags

string[]

Tags for categorization

data.included.debtor

object

Show child attributes

data.included.debtor.attributes

object

Option 1
Option 2

Show child attributes

data.included.debtor.attributes.type

string

Allowed value: "company"

data.included.debtor.attributes.id

string

Temp-id that references a debtor in the relationships

data.included.debtor.attributes.attributes

object

Show child attributes

data.included.debtor.attributes.attributes.registration

object

required

Option 1
Option 2

Show child attributes

data.included.debtor.attributes.attributes.registration.registered_name

string

required

Legal company name

Example:

"TechCorp AI Solutions LLC"

data.included.debtor.attributes.attributes.registration.trade_name

string

Commercial or branding name (if different from registered name).

Example:

"TechSol"

data.included.debtor.attributes.attributes.locale

string

Language settings.That’s the locale for the business relationship. Emails or documents can be used to identify the locale. Default EN.

Example:

"en-US"

data.included.debtor.attributes.attributes.domain_name_primary_link_url

string<uri>

The domain url from the website or email address of the company. Used as unique identifier in some cases.

Example:

"https://www.techcorp.com"

data.included.debtor.attributes.attributes.tax_id

object

Show child attributes

data.included.debtor.attributes.attributes.tax_id.value

string

Tax ID issued by local or national tax authority.

Example:

"DE123456789"

data.included.debtor.attributes.attributes.tax_id.type

string

Type of tax ID, useful for applying formatting and validation rules.all tax id types See all available labels for complete list.

Example:

["VAT", "TVA", "IVA", "..."]

data.included.debtor.attributes.attributes.registration_number

object

Show child attributes

data.included.debtor.attributes.attributes.registration_number.business_type

enum<string>

Legal entity structure type. See all business entity types for complete list.

Available options:

Inc,

Corp,

LLC,

GmbH,

Ltd,

SA,

SAS

Example:

"GmbH"

data.included.debtor.attributes.attributes.registration_number.value

string

Official company registration number.

Example:

"HRB 123456"

data.included.debtor.attributes.attributes.registration_number.registry_name

string

Name of the official registration body. See all available registry name for complete list.

Example:

"Handelsregister Berlin"

data.included.debtor.attributes.attributes.registration_number.registry_country

string

Country of the registry authority. Must be valid ISO country code

Example:

"DE, FR, US, etc."

data.included.debtor.attributes.attributes.description

string

Company description explaining business purpose in max 2 sentences.

Required string length: 1 - 500

Example:

"An innovative technology company focused on AI solutions"

data.included.creditor

object

Show child attributes

data.included.creditor.attributes

object

Option 1
Option 2

Show child attributes

data.included.creditor.attributes.type

string

Allowed value: "company"

data.included.creditor.attributes.id

string

Temp-id that references a creditor in the relationships

data.included.creditor.attributes.attributes

object

Show child attributes

data.included.creditor.attributes.attributes.registration

object

required

Option 1
Option 2

Show child attributes

data.included.creditor.attributes.attributes.registration.registered_name

string

required

Legal company name

Example:

"TechCorp AI Solutions LLC"

data.included.creditor.attributes.attributes.registration.trade_name

string

Commercial or branding name (if different from registered name).

Example:

"TechSol"

data.included.creditor.attributes.attributes.locale

string

Language settings.That’s the locale for the business relationship. Emails or documents can be used to identify the locale. Default EN.

Example:

"en-US"

data.included.creditor.attributes.attributes.domain_name_primary_link_url

string<uri>

The domain url from the website or email address of the company. Used as unique identifier in some cases.

Example:

"https://www.techcorp.com"

data.included.creditor.attributes.attributes.tax_id

object

Show child attributes

data.included.creditor.attributes.attributes.tax_id.value

string

Tax ID issued by local or national tax authority.

Example:

"DE123456789"

data.included.creditor.attributes.attributes.tax_id.type

string

Type of tax ID, useful for applying formatting and validation rules.all tax id types See all available labels for complete list.

Example:

["VAT", "TVA", "IVA", "..."]

data.included.creditor.attributes.attributes.registration_number

object

Show child attributes

data.included.creditor.attributes.attributes.registration_number.business_type

enum<string>

Legal entity structure type. See all business entity types for complete list.

Available options:

Inc,

Corp,

LLC,

GmbH,

Ltd,

SA,

SAS

Example:

"GmbH"

data.included.creditor.attributes.attributes.registration_number.value

string

Official company registration number.

Example:

"HRB 123456"

data.included.creditor.attributes.attributes.registration_number.registry_name

string

Name of the official registration body. See all available registry name for complete list.

Example:

"Handelsregister Berlin"

data.included.creditor.attributes.attributes.registration_number.registry_country

string

Country of the registry authority. Must be valid ISO country code

Example:

"DE, FR, US, etc."

data.included.creditor.attributes.attributes.description

string

Company description explaining business purpose in max 2 sentences.

Required string length: 1 - 500

Example:

"An innovative technology company focused on AI solutions"

data.included.documents

object

Show child attributes

data.included.documents.data

object[]

Show child attributes

data.included.documents.data.type

enum<string>

Available options:

document,

invoice

data.included.documents.data.id

string

Temp-id that references a documents in the relationships

data.included.documents.data.attributes

object

Show child attributes

data.included.documents.data.attributes.file_name

string

data.included.documents.data.attributes.status

string

data.included.documents.data.attributes.file_type

string

data.included.documents.data.attributes.size_bytes

integer

data.included.created_by

object

Show child attributes

data.included.created_by.data

object

Show child attributes

data.included.created_by.data.type

string

Allowed value: "people"

data.included.created_by.data.id

string

Temp-id that references a people who create the transaction in the relationships

data.included.created_by.data.attributes

object

Show child attributes

data.included.created_by.data.attributes.first_name

string

required

First name of the person

Required string length: 1 - 50

Example:

"John"

data.included.created_by.data.attributes.last_name

string

required

Last name of the person (required)

Required string length: 1 - 50

Example:

"Doe"

data.included.workspaces

object

Show child attributes

data.included.workspaces.data

object

Show child attributes

data.included.workspaces.data.type

string

Allowed value: "workspace"

data.included.workspaces.data.id

string

Temp-id that workspaces a creditor in the relationships

data.included.workspaces.data.attributes

object

Show child attributes

data.included.workspaces.data.attributes.name

string

required

Workspace name

Required string length: 1 - 255

data.included.workspaces.data.attributes.description

string

Workspace description

Maximum string length: 1000

data.included.workspaces.data.attributes.avatar_color

string

Avatar color in hexadecimal format (e.g., #FF5733)

data.included.workspaces.data.attributes.external_workspace_id

string

External workspace identifier

Required string length: 1 - 255

Response

Transaction updated successfully

data

object

Show child attributes

data.type

string

Allowed value: "transaction"

data.id

string<uuid>

UUID of the created transaction

Example:

"550e8400-e29b-41d4-a716-446655440010"

data.attributes

object

Show child attributes

data.attributes.scheme

enum<string>

Payment scheme used for the transaction

Available options:

sepa,

swift,

ach,

faster_payments,

instant_credit_transfer

data.attributes.external_ids

object

Show child attributes

data.attributes.external_ids.transaction_id

string

External transaction identifier from payment provider

data.attributes.external_ids.payment_request_id

string

Payment request identifier

data.attributes.external_ids.end_to_end_id

string

End-to-end reference for tracing the transaction

data.attributes.requested_execution_date

string<date>

Date when transaction execution was requested

data.attributes.executed_at

string<date-time>

Timestamp when transaction was executed

data.attributes.booking_date

string<date>

Date when transaction was booked

data.attributes.value_date

string<date>

Value date of the transaction

data.attributes.instructed_amount

object

Show child attributes

data.attributes.instructed_amount.currency

string

ISO 4217 currency code

data.attributes.instructed_amount.amount

number

Amount instructed for the transaction

Required range: x >= 0

data.attributes.settlement_amount

object

Show child attributes

data.attributes.settlement_amount.currency

string

ISO 4217 currency code

data.attributes.settlement_amount.amount

number

Amount settled for the transaction

Required range: x >= 0

data.attributes.foreign_exchange

object

Show child attributes

data.attributes.foreign_exchange.currency_rate

string

Exchange rate applied

data.attributes.foreign_exchange.currency_pair

string

Currency pair (e.g., EURUSD)

data.attributes.foreign_exchange.currency_rate_source

string

Source of the exchange rate

data.attributes.foreign_exchange.currency_rate_at

string<date-time>

Timestamp when exchange rate was applied

data.attributes.transaction_type

enum<string>

Type of transaction. See transaction types documentation for complete list.

Available options:

payment,

transfer,

deposit,

withdrawal,

card_payment,

direct_debit,

refund,

fee,

interest,

other

data.attributes.status

enum<string>

Current status of the transaction

Available options:

pending,

completed,

failed,

cancelled,

rejected

data.attributes.category_purpose

string

ISO 20022 category purpose code

data.attributes.purpose_code

string

ISO 20022 purpose code

data.attributes.remittance_information

object

Show child attributes

data.attributes.remittance_information.unstructured

string

Unstructured remittance information

data.attributes.remittance_information.structured_reference

string

Structured creditor reference

data.attributes.remittance_information.reference_type

enum<string>

Type of structured reference. See remittance reference types for details.

Available options:

SCOR,

RADM,

RPIN,

FXDR,

DISP,

PUOR,

SCNR

data.attributes.fees

object[]

Show child attributes

data.attributes.fees.type

enum<string>

Type of fee. See banking transaction fees for details.

Available options:

transfer_fee,

exchange_fee,

processing_fee,

commission

data.attributes.fees.amount

number

Fee amount

Required range: x >= 0

data.attributes.fees.currency

string

ISO 4217 currency code

data.attributes.created_at

string<date-time>

Timestamp when transaction was created

data.attributes.updated_at

string<date-time>

Timestamp when transaction was last updated

data.relationships

object

Show child attributes

data.relationships.debtor_payment_means

object

Show child attributes

data.relationships.debtor_payment_means.data

object

Show child attributes

data.relationships.debtor_payment_means.data.type

string

Allowed value: "payment_means"

data.relationships.debtor_payment_means.data.id

string<uuid>

UUID of the debtor payment means (source)

data.relationships.creditor_payment_means

object

Show child attributes

data.relationships.creditor_payment_means.data

object

Show child attributes

data.relationships.creditor_payment_means.data.type

string

Allowed value: "payment_means"

data.relationships.creditor_payment_means.data.id

string<uuid>

UUID of the creditor payment means (destination)

data.relationships.debtor

object

Show child attributes

data.relationships.debtor.data

object

Show child attributes

data.relationships.debtor.data.type

enum<string>

Type of debtor entity

Available options:

company,

people

data.relationships.debtor.data.id

string<uuid>

UUID of the debtor (entity that initiated the payment)

data.relationships.creditor

object

Show child attributes

data.relationships.creditor.data

object

Show child attributes

data.relationships.creditor.data.type

enum<string>

Type of creditor entity

Available options:

company,

people

data.relationships.creditor.data.id

string<uuid>

UUID of the creditor (entity that received the payment)

data.relationships.documents

object

Show child attributes

data.relationships.documents.data

object[]

Show child attributes

data.relationships.documents.data.type

enum<string>

Type of document

Available options:

document,

invoice

data.relationships.documents.data.id

string<uuid>

UUID of the document (receipts, confirmations, invoices)

data.relationships.created_by

object

Show child attributes

data.relationships.created_by.data

object

Show child attributes

data.relationships.created_by.data.type

string

Allowed value: "people"

data.relationships.created_by.data.id

string<uuid>

UUID of the user who created the transaction record

data.relationships.workspaces

object

Show child attributes

data.relationships.workspaces.data

object[]

Show child attributes

data.relationships.workspaces.data.type

string

Allowed value: "workspace"

data.relationships.workspaces.data.id

string<uuid>

UUID of the workspace associated with this transaction

data.included

object

Show child attributes

data.included.debtor_payment_means

object

Show child attributes

data.included.debtor_payment_means.data

object

Show child attributes

data.included.debtor_payment_means.data.type

string

Allowed value: "payment_means"

data.included.debtor_payment_means.data.id

string<uuid>

UUID of the debtor payment means (source)

data.included.debtor_payment_means.data.attributes

object

Show child attributes

data.included.debtor_payment_means.data.attributes.type

enum<string>

Type of payment means. See payment means types for details.

Available options:

card_details,

account_details,

wallet_details,

cash_details,

check_details,

crypto_details,

other

data.included.debtor_payment_means.data.attributes.scheme

enum<string>

Payment scheme or network. See scheme types for details.

Available options:

SEPA,

SWIFT,

ACH,

FASTER_PAYMENTS,

VISA,

MASTERCARD,

AMEX,

PAYPAL,

APPLEPAY,

GOOGLEPAY,

STRIPE,

LOCAL,

OTHER

data.included.debtor_payment_means.data.attributes.status

enum<string>

Current status of the payment means. See payment means status for details.

Available options:

active,

inactive,

pending_verification,

suspended,

expired,

blocked

data.included.debtor_payment_means.data.attributes.account_details

object

Bank account details for account_details type

Show child attributes

data.included.debtor_payment_means.data.attributes.account_details.iban

string

International Bank Account Number

data.included.debtor_payment_means.data.attributes.account_details.bic

string

Bank Identifier Code (SWIFT)

data.included.debtor_payment_means.data.attributes.account_details.account_number

string

Local account number (alternative to IBAN)

data.included.debtor_payment_means.data.attributes.account_details.routing_number

string

Bank routing number (US ACH)

data.included.debtor_payment_means.data.attributes.account_details.currency

string

Currency code (ISO 4217)

data.included.debtor_payment_means.data.attributes.bank_details

object

Additional bank information

Show child attributes

data.included.debtor_payment_means.data.attributes.bank_details.bank_name

string

Name of the bank

data.included.debtor_payment_means.data.attributes.bank_details.bank_code

string

Bank code or identifier

data.included.debtor_payment_means.data.attributes.bank_details.branch_name

string

Bank branch name

data.included.debtor_payment_means.data.attributes.bank_details.branch_code

string

Bank branch code

data.included.debtor_payment_means.data.attributes.card_details

object

Credit/debit card details for card_details type

Show child attributes

data.included.debtor_payment_means.data.attributes.card_details.masked_pan

string

Masked Primary Account Number (PCI DSS compliant)

data.included.debtor_payment_means.data.attributes.card_details.brand

enum<string>

Card brand

Available options:

visa,

mastercard,

amex,

discover,

diners,

jcb,

unionpay,

other

data.included.debtor_payment_means.data.attributes.card_details.card_type

enum<string>

Type of card

Available options:

credit,

debit,

prepaid,

charge

data.included.debtor_payment_means.data.attributes.card_details.expiry_month

integer

Card expiry month

data.included.debtor_payment_means.data.attributes.card_details.expiry_year

integer

Card expiry year

data.included.debtor_payment_means.data.attributes.card_details.cardholder_name

string

Name as printed on card

data.included.debtor_payment_means.data.attributes.digital_wallet

object

Digital wallet details for wallet_details type

Show child attributes

data.included.debtor_payment_means.data.attributes.digital_wallet.provider

enum<string>

Digital wallet provider

Available options:

paypal,

applepay,

googlepay,

stripe,

square,

venmo,

cashapp,

other

data.included.debtor_payment_means.data.attributes.digital_wallet.wallet_id

string

Wallet identifier (email, phone, etc.)

data.included.debtor_payment_means.data.attributes.digital_wallet.wallet_type

enum<string>

Type of wallet account

Available options:

personal,

business,

merchant

data.included.debtor_payment_means.data.attributes.compliance

object

Compliance and verification status

Show child attributes

data.included.debtor_payment_means.data.attributes.compliance.kyc_status

enum<string>

Know Your Customer verification status

Available options:

pending,

in_progress,

completed,

failed,

not_required

data.included.debtor_payment_means.data.attributes.compliance.aml_status

enum<string>

Anti-Money Laundering check status

Available options:

pending,

in_progress,

cleared,

flagged,

not_required

data.included.debtor_payment_means.data.attributes.compliance.sanctions_check

enum<string>

Sanctions screening status

Available options:

pending,

passed,

failed,

not_required

data.included.debtor_payment_means.data.attributes.compliance.last_compliance_check

string<date-time>

Last compliance check timestamp

data.included.debtor_payment_means.data.attributes.metadata

object

System metadata

Show child attributes

data.included.debtor_payment_means.data.attributes.metadata.source

enum<string>

How the payment means was created

Available options:

api,

dashboard,

import,

connector

data.included.debtor_payment_means.data.attributes.metadata.external_id

string

External system identifier

data.included.debtor_payment_means.data.attributes.nickname

string

User-friendly name for the payment means

data.included.debtor_payment_means.data.attributes.description

string

Additional description of the payment means

data.included.debtor_payment_means.data.attributes.tags

string[]

Tags for categorization

data.included.debtor_payment_means.data.attributes.created_at

string<date-time>

Creation timestamp

data.included.debtor_payment_means.data.attributes.updated_at

string<date-time>

Last update timestamp

data.included.creditor_payment_means

object

Show child attributes

data.included.creditor_payment_means.data

object

Show child attributes

data.included.creditor_payment_means.data.type

string

Allowed value: "payment_means"

data.included.creditor_payment_means.data.id

string<uuid>

UUID of the creditor payment means (destination)

data.included.creditor_payment_means.data.attributes

object

Show child attributes

data.included.creditor_payment_means.data.attributes.type

enum<string>

Type of payment means. See payment means types for details.

Available options:

card_details,

account_details,

wallet_details,

cash_details,

check_details,

crypto_details,

other

data.included.creditor_payment_means.data.attributes.scheme

enum<string>

Payment scheme or network. See scheme types for details.

Available options:

SEPA,

SWIFT,

ACH,

FASTER_PAYMENTS,

VISA,

MASTERCARD,

AMEX,

PAYPAL,

APPLEPAY,

GOOGLEPAY,

STRIPE,

LOCAL,

OTHER

data.included.creditor_payment_means.data.attributes.status

enum<string>

Current status of the payment means. See payment means status for details.

Available options:

active,

inactive,

pending_verification,

suspended,

expired,

blocked

data.included.creditor_payment_means.data.attributes.account_details

object

Bank account details for account_details type

Show child attributes

data.included.creditor_payment_means.data.attributes.account_details.iban

string

International Bank Account Number

data.included.creditor_payment_means.data.attributes.account_details.bic

string

Bank Identifier Code (SWIFT)

data.included.creditor_payment_means.data.attributes.account_details.account_number

string

Local account number (alternative to IBAN)

data.included.creditor_payment_means.data.attributes.account_details.routing_number

string

Bank routing number (US ACH)

data.included.creditor_payment_means.data.attributes.account_details.currency

string

Currency code (ISO 4217)

data.included.creditor_payment_means.data.attributes.bank_details

object

Additional bank information

Show child attributes

data.included.creditor_payment_means.data.attributes.bank_details.bank_name

string

Name of the bank

data.included.creditor_payment_means.data.attributes.bank_details.bank_code

string

Bank code or identifier

data.included.creditor_payment_means.data.attributes.bank_details.branch_name

string

Bank branch name

data.included.creditor_payment_means.data.attributes.bank_details.branch_code

string

Bank branch code

data.included.creditor_payment_means.data.attributes.card_details

object

Credit/debit card details for card_details type

Show child attributes

data.included.creditor_payment_means.data.attributes.card_details.masked_pan

string

Masked Primary Account Number (PCI DSS compliant)

data.included.creditor_payment_means.data.attributes.card_details.brand

enum<string>

Card brand

Available options:

visa,

mastercard,

amex,

discover,

diners,

jcb,

unionpay,

other

data.included.creditor_payment_means.data.attributes.card_details.card_type

enum<string>

Type of card

Available options:

credit,

debit,

prepaid,

charge

data.included.creditor_payment_means.data.attributes.card_details.expiry_month

integer

Card expiry month

data.included.creditor_payment_means.data.attributes.card_details.expiry_year

integer

Card expiry year

data.included.creditor_payment_means.data.attributes.card_details.cardholder_name

string

Name as printed on card

data.included.creditor_payment_means.data.attributes.digital_wallet

object

Digital wallet details for wallet_details type

Show child attributes

data.included.creditor_payment_means.data.attributes.digital_wallet.provider

enum<string>

Digital wallet provider

Available options:

paypal,

applepay,

googlepay,

stripe,

square,

venmo,

cashapp,

other

data.included.creditor_payment_means.data.attributes.digital_wallet.wallet_id

string

Wallet identifier (email, phone, etc.)

data.included.creditor_payment_means.data.attributes.digital_wallet.wallet_type

enum<string>

Type of wallet account

Available options:

personal,

business,

merchant

data.included.creditor_payment_means.data.attributes.compliance

object

Compliance and verification status

Show child attributes

data.included.creditor_payment_means.data.attributes.compliance.kyc_status

enum<string>

Know Your Customer verification status

Available options:

pending,

in_progress,

completed,

failed,

not_required

data.included.creditor_payment_means.data.attributes.compliance.aml_status

enum<string>

Anti-Money Laundering check status

Available options:

pending,

in_progress,

cleared,

flagged,

not_required

data.included.creditor_payment_means.data.attributes.compliance.sanctions_check

enum<string>

Sanctions screening status

Available options:

pending,

passed,

failed,

not_required

data.included.creditor_payment_means.data.attributes.compliance.last_compliance_check

string<date-time>

Last compliance check timestamp

data.included.creditor_payment_means.data.attributes.metadata

object

System metadata

Show child attributes

data.included.creditor_payment_means.data.attributes.metadata.source

enum<string>

How the payment means was created

Available options:

api,

dashboard,

import,

connector

data.included.creditor_payment_means.data.attributes.metadata.external_id

string

External system identifier

data.included.creditor_payment_means.data.attributes.nickname

string

User-friendly name for the payment means

data.included.creditor_payment_means.data.attributes.description

string

Additional description of the payment means

data.included.creditor_payment_means.data.attributes.tags

string[]

Tags for categorization

data.included.creditor_payment_means.data.attributes.created_at

string<date-time>

Creation timestamp

data.included.creditor_payment_means.data.attributes.updated_at

string<date-time>

Last update timestamp

data.included.debtor

object

Show child attributes

data.included.debtor.attributes

object

Option 1
Option 2

Show child attributes

data.included.debtor.attributes.type

string

Allowed value: "company"

data.included.debtor.attributes.id

string<uuid>

data.included.debtor.attributes.attributes

object

Show child attributes

data.included.debtor.attributes.attributes.description

string

data.included.debtor.attributes.attributes.domain_name_primary_link_url

string<url>

The domain url from the website or email address of the company. Used as unique identifier in some cases.

Maximum string length: 500

data.included.debtor.attributes.attributes.tax_id

object

Show child attributes

data.included.debtor.attributes.attributes.tax_id.value

string

Tax ID issued by local or national tax authority.

data.included.debtor.attributes.attributes.tax_id.type

string

Type of tax ID, useful for applying formatting and validation rules.

data.included.debtor.attributes.attributes.registration

object

Show child attributes

data.included.debtor.attributes.attributes.registration.trade_name

string

Commercial or branding name (if different from registered name).

data.included.debtor.attributes.attributes.registration.registered_name

string

Legal company name.

Required string length: 1 - 100

data.included.debtor.attributes.attributes.registration_number

object

Show child attributes

data.included.debtor.attributes.attributes.registration_number.business_type

string

Legal entity structure type.

data.included.debtor.attributes.attributes.registration_number.value

string

Official company registration number.

data.included.debtor.attributes.attributes.registration_number.registry_name

string

Name of the official registration body.

data.included.debtor.attributes.attributes.registration_number.registry_country

string

Country of the registry authority. (string (ISO 3166-1 alpha-2))

data.included.debtor.attributes.attributes.workspace_id

string<uuid>

UUID of the workspace associated with this company

data.included.debtor.attributes.attributes.created_at

string<date-time>

data.included.debtor.attributes.attributes.updated_at

string<date-time>

data.included.creditor

object

Show child attributes

data.included.creditor.attributes

object

Option 1
Option 2

Show child attributes

data.included.creditor.attributes.type

string

Allowed value: "company"

data.included.creditor.attributes.id

string<uuid>

data.included.creditor.attributes.attributes

object

Show child attributes

data.included.creditor.attributes.attributes.description

string

data.included.creditor.attributes.attributes.domain_name_primary_link_url

string<url>

The domain url from the website or email address of the company. Used as unique identifier in some cases.

Maximum string length: 500

data.included.creditor.attributes.attributes.tax_id

object

Show child attributes

data.included.creditor.attributes.attributes.tax_id.value

string

Tax ID issued by local or national tax authority.

data.included.creditor.attributes.attributes.tax_id.type

string

Type of tax ID, useful for applying formatting and validation rules.

data.included.creditor.attributes.attributes.registration

object

Show child attributes

data.included.creditor.attributes.attributes.registration.trade_name

string

Commercial or branding name (if different from registered name).

data.included.creditor.attributes.attributes.registration.registered_name

string

Legal company name.

Required string length: 1 - 100

data.included.creditor.attributes.attributes.registration_number

object

Show child attributes

data.included.creditor.attributes.attributes.registration_number.business_type

string

Legal entity structure type.

data.included.creditor.attributes.attributes.registration_number.value

string

Official company registration number.

data.included.creditor.attributes.attributes.registration_number.registry_name

string

Name of the official registration body.

data.included.creditor.attributes.attributes.registration_number.registry_country

string

Country of the registry authority. (string (ISO 3166-1 alpha-2))

data.included.creditor.attributes.attributes.workspace_id

string<uuid>

UUID of the workspace associated with this company

data.included.creditor.attributes.attributes.created_at

string<date-time>

data.included.creditor.attributes.attributes.updated_at

string<date-time>

data.included.documents

object

Show child attributes

data.included.documents.data

object[]

Show child attributes

data.included.documents.data.type

enum<string>

Type of document

Available options:

document,

invoice

data.included.documents.data.id

string<uuid>

UUID of the document (receipts, confirmations, invoices)

data.included.documents.data.attributes

object

Show child attributes

data.included.documents.data.attributes.file_name

string

data.included.documents.data.attributes.status

string

data.included.documents.data.attributes.uploaded_at

string<date-time>

data.included.documents.data.attributes.processed_at

string<date-time>

data.included.documents.data.attributes.file_type

string

data.included.documents.data.attributes.size_bytes

integer

data.included.created_by

object

Show child attributes

data.included.created_by.data

object

Show child attributes

data.included.created_by.data.type

string

Allowed value: "people"

data.included.created_by.data.id

string<uuid>

UUID of the user who created the transaction record

data.included.created_by.data.attributes

object

Show child attributes

data.included.created_by.data.attributes.first_name

string

The person's first name

data.included.created_by.data.attributes.last_name

string

The person's last name

data.included.created_by.data.attributes.full_name

string

The person's full name (typically first_name + last_name)

data.included.created_by.data.attributes.created_at

string<date-time>

Timestamp when the person was created

data.included.created_by.data.attributes.updated_at

string<date-time>

Timestamp when the person was last updated

data.included.workspaces

object

Show child attributes

data.included.workspaces.items

object

Show child attributes

data.included.workspaces.items.type

string

Allowed value: "workspace"

data.included.workspaces.items.id

string<uuid>

UUID of the workspace associated with this transaction

data.included.workspaces.items.attributes

object

Show child attributes

data.included.workspaces.items.attributes.name

string

Workspace name

data.included.workspaces.items.attributes.desription

string

Workspace description

data.included.workspaces.items.attributes.external_workspace_id

string<uuid>

external workspace id

data.included.workspaces.items.attributes.avatar_color

string<colors>

Color of the avatar

data.included.workspaces.items.attributes.created_at

string<date-time>

Timestamp when the workspace was created

data.included.workspaces.items.attributes.updated_at

string<date-time>

Timestamp when the workspace was last updated

Main Resources

Atomic Resources

System

Headers

Path Parameters

Body

Response