Axiym

Schemas

Data models used by the Client Account API.

View MarkdownView complete reference
64 schemas

OnboardingRequest

object
#

Client onboarding request.

legalEntityNameRequired
string

Official name of the company.

incorporationDateRequired
string

Date the legal entity was established.

Formatdate
registrationDateRequired
string

Date the company joined your network.

Formatdate
legalAddressRequired
Address

Legal address.

currencyRequired
Currency
partnerClientId
string

Your unique reference for the client within your partnership.

disbursementAccount
DisbursementAccount

Payment Network bank account that receives funding disbursements for this client (the funding destination).

paymentRails
string

Payment rail code.

OnboardingCase

object
#

Snapshot of a client onboarding application. Created in the submitted state and reviewed by Axiym compliance; while the review is in progress the status stays ONBOARDING. An approved application ends in APPROVED; a rejected application ends in REJECTED.

clientIdRequired
string

Client identifier (UUID).

Formatuuid
codeRequired
string

Human-readable client code.

legalEntityNameRequired
string

Official name of the company.

legalAddress
Address

Legal address.

incorporationDate
string

Date the legal entity was established.

Formatdate
registrationDate
string

Date the company joined your network.

Formatdate
statusRequired
string

Onboarding application status.

Allowed values
ONBOARDINGAPPROVEDREJECTED
currency
Currency

Currency code (ISO 4217 fiat or supported stablecoin).

disbursementAccount
DisbursementAccount

Payment Network bank account that receives funding disbursements for this client (the funding destination).

partnerClientId
string

Your reference for this client.

paymentRails
string

Payment rail — a configured settlement channel Axiym uses to hold and move funds: a banking partner for fiat (e.g. `ZENUS_BANK`, `FREEMARKET`) or a blockchain network for crypto (e.g. `TRON`, `AVALANCHE`). Codes are returned by `GET /settings/payment-rails`.

Client

object
#
clientIdRequired
string

Client identifier (UUID).

Formatuuid
codeRequired
string

Human-readable client code.

legalEntityNameRequired
string

Official name of the company.

legalAddressRequired
Address

Legal address.

incorporationDateRequired
string

Date the legal entity was established.

Formatdate
registrationDateRequired
string

Date the company joined your network.

Formatdate
statusRequired
string

Client status.

Allowed values
ONBOARDINGACTIVEDISABLED
currencyRequired
Currency

Currency code (ISO 4217 fiat or supported stablecoin).

disbursementAccount
DisbursementAccount

Payment Network bank account that receives funding disbursements for this client (the funding destination).

partnerClientId
string

Your reference for this client.

paymentRailsRequired
string

Payment rail — a configured settlement channel Axiym uses to hold and move funds: a banking partner for fiat (e.g. `ZENUS_BANK`, `FREEMARKET`) or a blockchain network for crypto (e.g. `TRON`, `AVALANCHE`). Codes are returned by `GET /settings/payment-rails`.

Address

object
#

Registered legal address of a business.

city
string

City or locality.

countryRequired
string

ISO 3166-1 alpha-2 country code.

Pattern^[A-Z]{2}$
addressRequired
string

First address line.

addressExtended
string

Second address line, where applicable.

district
string

State / County / Province / Region portion of the address. If the country is US or Canada, then district is required and should use the two-letter code for the subdivision.

postalCodeRequired
string

Postal or ZIP code.

DisbursementAccount

object
#

Bank account at the Payment Network that receives funding disbursements.

accountNumber
string

Bank account number.

Currency

string
#

Currency code — ISO 4217 (e.g. USD, EUR) or a supported digital currency (USDT, USDC).

AccountStatus

string
#

`ACTIVE` is available for supported operations. `SUSPENDED` is temporarily unavailable for supported operations. `CLOSED` is permanently closed.

Allowed values
ACTIVESUSPENDEDCLOSED

Account

object
#

An account holding a currency balance. Receiving details for funding it are served by the deposit instructions.

accountIdRequired
string

Account identifier (UUID).

Formatuuid
currencyRequired
Currency

Account currency.

paymentRailsRequired
PaymentRailsCode

Rail the account settles on.

balanceRequired
Decimal

Current balance.

statusRequired
AccountStatus

Account status.

AccountRef

object
#

Compact account reference. Fetch the account via `GET /clients/{clientId}/accounts/{accountId}` for the current balance and status; deposit instructions serve its payment details.

accountIdRequired
string

Account identifier (UUID).

Formatuuid
currencyRequired
Currency

Account currency.

paymentRailsRequired
PaymentRailsCode

Rail the account settles on.

PaymentRailsCode

string
#

Payment rail code the account settles on (e.g. `ZENUS_BANK`, `TRON`).

StatementEntryType

string
#

Direction of movement on the account.

Allowed values
CREDITDEBIT

StatementEntry

object
#

A posted ledger movement on an account. Entries are returned in posting order and carry the running balance, so consecutive entries reconcile against each other.

entryIdRequired
string

Ledger entry identifier (UUID).

Formatuuid
accountIdRequired
string

Account identifier (UUID).

Formatuuid
typeRequired
StatementEntryType

Credit or debit direction.

amountRequired
Decimal

Positive movement amount in the account currency; direction is in `type`.

currencyRequired
Currency

Account currency.

balanceBefore
Decimal

Running balance before this movement.

balanceAfterRequired
Decimal

Running balance after this movement.

relatedResourceType
string

Type of the linked money movement; absent for ledger adjustments with no linked resource.

Allowed values
DEPOSITWITHDRAWALCONVERSIONPAYOUTTRANSFER
relatedResourceId
string

Identifier of the linked resource, where present.

Formatuuid
occurredAtRequired
string

When the movement occurred. Formatted in ISO 8601.

Formatdate-time

ConversionStatus

string
#

`PENDING` awaits confirmation and appears only in the create response. `ACTIVE` is executing. `COMPLETED` means the funds were exchanged. `CANCELED` means the conversion stopped; see `reasonCode`.

Allowed values
PENDINGACTIVECOMPLETEDCANCELED

ConversionPair

object
#

An allowed exchange direction. You sell the `sell` side and buy the `buy` side. Use its stable `pairId` to create a conversion; Axiym selects the corresponding accounts.

pairIdRequired
string

Conversion pair identifier (UUID), stable for the pair and direction.

Formatuuid
pairRequired
string

Pair symbol, `<sellCurrency>-<buyCurrency>`.

sellRequired
ConversionPairSide

The side you sell.

buyRequired
ConversionPairSide

The side you buy.

minAmountRequired
Decimal

Minimum sell amount, in the sell currency.

ConversionPairSide

object
#

One side of a conversion pair.

currencyRequired
Currency

Side currency.

paymentRailsRequired
PaymentRailsCode

Rail the side settles on.

ConversionRequest

object
#

A conversion along one of your conversion pairs. `pairId` selects the accounts on both sides; `sellAmount` is in the pair's sell currency.

pairIdRequired
string

Conversion pair identifier from `GET /clients/{clientId}/conversion-pairs`.

Formatuuid
sellAmountRequired
Decimal

Amount to sell, in the pair's sell currency.

externalReference
ExternalReference

Your reference for correlation, echoed back on related objects.

Conversion

object
#
conversionIdRequired
string

Conversion identifier (UUID).

Formatuuid
pairIdRequired
string

The conversion pair this conversion runs along.

Formatuuid
statusRequired
ConversionStatus

Conversion status.

reasonCode
string

Present when `status` is `CANCELED` — the reason as reported by operations or the liquidity venue. Example: `RATE_EXPIRED`.

sellAccountRequired
AccountRef

The sell-side account, embedded as a compact reference.

sellAmountRequired
Money

Amount to sell, in the sell currency. It represents the quoted amount before execution and the amount sold once `COMPLETED`.

buyAccountRequired
AccountRef

The buy-side account, embedded as a compact reference.

buyAmountRequired
Money

Expected amount to credit to the buy-side account. It represents the amount credited once the conversion is `COMPLETED`.

rateRequired
Decimal

Units of buy currency received for one unit of sell currency.

feeRequired
Money

Conversion fee, in the ISO 4217 currency of the pair. The quote includes this fee before execution. It is deducted from the sell amount when buying digital currency and from the buy proceeds when selling it.

externalReference
ExternalReference

Your reference for correlation, echoed back on related objects.

createdAtRequired
string

Creation timestamp. Formatted in ISO 8601.

Formatdate-time
completedAt
string

Completion timestamp. Formatted in ISO 8601.

Formatdate-time

ConversionEventData

object
#

A compact notification for routing and correlation. Retrieve the conversion from `GET /clients/{clientId}/conversions/{conversionId}` when you need its amounts, rate, or current state.

conversionIdRequired
string

Conversion identifier (UUID).

Formatuuid
statusRequired
ConversionStatus

Conversion status at the time the event was emitted.

externalReference
ExternalReference

Your reference submitted on creation, where present.

reasonCode
string

Present on `conversion.canceled` — the reason as reported by operations or the liquidity venue. Example: `RATE_EXPIRED`.

clientIdRequired
string

Axiym identifier of the client that owns the resource.

Formatuuid

DepositStatus

string
#

`PENDING` awaits crediting. `HELD` is temporarily on hold. `COMPLETED` was credited to the account. `CANCELED` or `REJECTED` was not completed; see `reasonCode`.

Allowed values
PENDINGHELDCOMPLETEDCANCELEDREJECTED

Deposit

object
#
depositIdRequired
string

Deposit identifier (UUID).

Formatuuid
accountRequired
AccountRef

The account the deposit credits, embedded as a compact reference.

amountRequired
Money

Deposit amount in the receiving account currency. The amount is credited when the deposit is `COMPLETED`.

fee
Money

Deposit fee, where applicable. Its presence does not mean the deposit has been credited; check `status`.

statusRequired
DepositStatus

Deposit status.

remitterName
string

Name of the sender, as reported by the sending bank or network.

code
string

System-assigned payment code, shown on the payment.

transactionHash
string

The transaction hash on the network. Present for wallet deposits.

reasonCode
string

Present when `status` is `CANCELED` or `REJECTED` — the reason as reported by the bank, the network, or Axiym operations. Example: `SENDER_SCREENING_FAILED`.

createdAtRequired
string

Creation timestamp. Formatted in ISO 8601.

Formatdate-time

BankDepositInstruction

object
#

Axiym's receiving bank details for one transfer scheme. Exactly one of `iban` and `accountNumber` is present. Bank fields are present when the scheme uses them.

schemeRequired
TransferScheme
beneficiaryNameRequired
string

Name of the receiving party to put on the transfer.

beneficiaryAddress
BankAddress

Postal address of the receiving party. `country` is always present.

iban
Iban

IBAN to send to. Present instead of `accountNumber` when the account is identified by an IBAN.

accountNumber
string

Account number to send to. Present instead of `iban` when the account has no IBAN.

swiftBic
string

SWIFT/BIC code of the receiving bank.

clearingCode
string

Local clearing or routing code of the receiving bank (for example the ABA routing number for Fedwire and ACH).

clearingSystemCode
string

Clearing system `clearingCode` belongs to. Present together with `clearingCode`.

bankName
string

Receiving bank name.

bankAddress
BankAddress

Postal address of the receiving bank. `country` is always present.

intermediaryBank
DepositIntermediaryBank
reference
string

ISO 11649 creditor reference (`RF` + check digits) assigned by Axiym, formatted in groups of four. Present when the account is funded through a shared receiving account; include it on the transfer so the deposit is matched automatically (matching ignores the spaces). Absent when the receiving account number alone identifies the Axiym account.

DepositIntermediaryBank

object
#

Bank the transfer passes through before the receiving bank. Present when the scheme uses one; put it on the transfer as the intermediary bank.

swiftBic
string

SWIFT/BIC code of the intermediary bank.

clearingCode
string

Local clearing or routing code of the intermediary bank.

clearingSystemCode
string

Clearing system `clearingCode` belongs to. Present together with `clearingCode`.

bankName
string

Intermediary bank name.

bankAddress
BankAddress

Postal address of the intermediary bank. `country` is always present.

TransferScheme

string
#

Transfer scheme the instruction applies to. `BOOK` is a transfer between accounts held at the same provider; `BLOCKCHAIN` is a wallet transfer.

Allowed values
SWIFTFEDWIREACHSEPAFPSBOOKBLOCKCHAIN

WalletDepositInstruction

object
#
schemeRequired
string

Always `BLOCKCHAIN` for a wallet instruction.

Allowed values
BLOCKCHAIN
beneficiaryNameRequired
string

Name of the receiving party the address belongs to. The transfer itself carries no name; use it in your own records.

walletAddressRequired
string

Deposit address of the account; deposits are matched by the address itself.

networkRequired
Network

Network of the wallet address.

DepositEventData

object
#

A compact notification for routing and correlation. Retrieve the deposit from `GET /clients/{clientId}/deposits/{depositId}` when you need its amount, transaction hash, or current state.

depositIdRequired
string

Deposit identifier (UUID).

Formatuuid
statusRequired
DepositStatus

Deposit status at the time the event was emitted.

reasonCode
string

Present on `deposit.canceled` / `deposit.rejected` — the reason as reported by the bank, the network, or Axiym operations. Example: `SENDER_SCREENING_FAILED`.

clientIdRequired
string

Axiym identifier of the client that owns the resource.

Formatuuid

Bank

object
#

Destination bank details. Present on bank destinations only. The address country selects the applicable corridor rules.

bankNameRequired
string

Bank name.

Min length1
addressRequired
BankAddress
swiftBic
string

ISO 9362 SWIFT/BIC, when required for the corridor.

Pattern^[A-Z]{6}[A-Z0-9]{2}([A-Z0-9]{3})?$
clearingCode
string

Local clearing or routing code, when required for the corridor.

clearingSystemCode
string

Clearing system the code belongs to. Axiym derives it from the bank country; supply it where a country has more than one system.

Iban

string
#

International Bank Account Number in electronic format — no spaces, upper case. Its check digits are verified; country-specific lengths are left to the receiving bank.

Pattern^[A-Z]{2}[0-9]{2}[A-Z0-9]{10,30}$

BankAddress

object
#

Postal address of the bank. Only the country is required — it selects the corridor rules. Supply the rest when the corridor or a correspondent asks for it.

streetName
string
buildingNumber
string
city
string
region
string
postalCode
string
countryRequired
CountryCode

CountryCode

string
#

ISO 3166-1 alpha-2 country code.

Pattern^[A-Z]{2}$

DestinationStatus

string
#

`PENDING_REVIEW` awaits due diligence and compliance checks. `ACTIVE` is whitelisted for deposits and withdrawals. `SUSPENDED` is temporarily unavailable. `CLOSED` is permanently retired.

Allowed values
PENDING_REVIEWACTIVESUSPENDEDCLOSED

AddressBookEntry

BankAddressBookEntry | WalletAddressBookEntry
#

A registered external bank account or wallet in the selected client's address book. Its status indicates whether it is whitelisted for deposits and withdrawals. A bank account contains either `iban` or `accountNumber`, together with `bank`. A wallet contains `walletAddress` and `network`. The two field sets never appear together.

BankAddressBookEntry

object
#

A registered external bank account. Exactly one of `iban` and `accountNumber` is present.

One of
IBANAccount number
destinationIdRequired
string

Identifier of the external account in the selected client's address book (UUID).

Formatuuid
statusRequired
DestinationStatus

Review and availability status of the registered external account.

currencyRequired
Currency

Currency associated with the registered external account.

iban
Iban

IBAN of the account. Present instead of `accountNumber` when the account is identified by an IBAN.

accountNumber
string

Domestic bank account number. Present instead of `iban` when the account has no IBAN.

bankRequired
Bank

Destination bank details.

createdAt
string

Creation timestamp. Formatted in ISO 8601.

Formatdate-time

WalletAddressBookEntry

object
#
destinationIdRequired
string

Identifier of the external account in the selected client's address book (UUID).

Formatuuid
statusRequired
DestinationStatus

Review and availability status of the registered external account.

currencyRequired
Currency

Currency associated with the registered external account.

walletAddressRequired
string

Wallet address of the entry; static and reusable.

networkRequired
Network

Network of the wallet address.

createdAt
string

Creation timestamp. Formatted in ISO 8601.

Formatdate-time

Destination

BankDestination | WalletDestination
#

Where the funds are delivered, as recorded on the operation at creation time. This is a snapshot: it carries the account or wallet details and, when the destination was taken from the address book, its `destinationId`. It does not carry the address book entry's status or creation date; read the address book entry for its current state. - A bank destination contains `iban` or `accountNumber`, and `bank`. - A wallet destination contains `walletAddress` and `network`. The two field sets never appear together.

BankDestination

object
#

The bank account the funds are delivered to. Exactly one of `iban` and `accountNumber` is present.

One of
IBANAccount number
destinationId
string

Address book entry the destination was taken from, when applicable.

Formatuuid
currencyRequired
Currency

Currency delivered to the destination.

iban
Iban

IBAN of the account. Present instead of `accountNumber` when the account is identified by an IBAN.

accountNumber
string

Domestic bank account number. Present instead of `iban` when the account has no IBAN.

bankRequired
Bank

Destination bank details.

WalletDestination

object
#
destinationId
string

Address book entry the destination was taken from, when applicable.

Formatuuid
currencyRequired
Currency

Currency delivered to the destination.

walletAddressRequired
string

Wallet address on the given network.

networkRequired
Network

Network of the wallet address.

BankDestinationRequest

object
#

Registers an external bank account for whitelisting in the selected client's address book. The entry starts in `PENDING_REVIEW` while Axiym performs due diligence and compliance checks. It can fund deposits and receive withdrawals once `ACTIVE`. Supply exactly one of `iban` and `accountNumber`.

One of
IBANAccount number
currencyRequired
Currency

Currency associated with the external bank account.

iban
Iban

IBAN of the account. Supply it instead of `accountNumber` when the account has an IBAN; the check digits are verified.

accountNumber
string

Domestic bank account number. Supply it instead of `iban` when the account has no IBAN.

bankRequired
Bank

Destination bank details.

WalletDestinationRequest

object
#

Registers an external wallet for whitelisting in the selected client's address book. The entry starts in `PENDING_REVIEW` while Axiym performs due diligence and compliance checks. It can fund deposits and receive withdrawals once `ACTIVE`.

currencyRequired
Currency

Currency associated with the external wallet.

walletAddressRequired
string

Wallet address to register as an external account.

networkRequired
Network

Network of the wallet address.

PageInfo

object
#
hasNextPageRequired
boolean

When paginating forwards, are there more items?

endCursor
string

When paginating forwards, the cursor to continue.

WithdrawalStatus

string
#

`PENDING_CONFIRMATION` is awaiting explicit confirmation and has not started execution. `PENDING` is queued for execution. `HELD` is temporarily on hold. `COMPLETED` means the withdrawal finished successfully. `CANCELED` and `REJECTED` did not complete (see `reasonCode`).

Allowed values
PENDING_CONFIRMATIONPENDINGHELDCOMPLETEDCANCELEDREJECTED

Withdrawal

object
#
withdrawalIdRequired
string

Withdrawal identifier (UUID).

Formatuuid
sourceAccountRequired
AccountRef

The source account, embedded as a compact reference.

sourceAmountRequired
Money

Amount to debit from the source Axiym account, in its currency. This amount is included before execution; check `status` for withdrawal progress.

destinationAmountRequired
Money

Amount to deliver to the external account, in its currency. Equals `sourceAmount` less `fee`. This amount is included before execution; check `status` for withdrawal progress.

feeRequired
Money

Fee to deduct from `sourceAmount` before delivery, in the source account currency. Zero when no fee applies. This amount is included before execution.

destinationRequired
Destination

Snapshot of the destination selected by `destinationId` at creation time.

statusRequired
WithdrawalStatus

Withdrawal status.

code
string

System-assigned payment code, shown on the payment.

reference
string

Text shown to the recipient, as submitted.

supportingDocuments
SupportingDocument[]

Documents accepted with the payment. File content is not returned.

externalReference
ExternalReference

Your reference for correlation, echoed back on related objects.

transactionHash
string

The transaction hash on the network. Present for wallet withdrawals once the withdrawal is `COMPLETED`.

reasonCode
string

Present when `status` is `CANCELED` or `REJECTED` — the cancellation/rejection reason as reported by the bank, the network, or Axiym operations. Example: `INSUFFICIENT_BENEFICIARY_DETAILS`.

createdAtRequired
string

Creation timestamp. Formatted in ISO 8601.

Formatdate-time

WithdrawalRequest

object
#

A withdrawal from the selected client's Axiym account to a whitelisted external account identified by `destinationId` in that client's address book. Both accounts must be `ACTIVE` and use the same currency. Creating the withdrawal returns `PENDING_CONFIRMATION`; call `POST /clients/{clientId}/withdrawals/{withdrawalId}/confirm` to begin execution.

sourceAccountIdRequired
string

Source account identifier (UUID).

Formatuuid
sourceAmountRequired
Money

Amount to debit from the source account. Its currency must be the source account currency.

destinationIdRequired
string

Identifier of the whitelisted external account in the selected client's address book. It must be `ACTIVE` and use the source Axiym account's currency.

Formatuuid
reference
string

Text shown to the recipient, typically the invoice number.

Max length140
supportingDocuments
SupportingDocumentInput[]

Documents supporting the payment, such as an invoice. Required where the destination corridor requires evidence.

Max items10
externalReference
ExternalReference

Your reference for correlation, echoed back on related objects.

SupportingDocumentType

string
#

Axiym classification of evidence supplied with a withdrawal.

Allowed values
PASSPORTNATIONAL_IDDRIVER_LICENSERESIDENCE_PERMITPROOF_OF_ADDRESSUTILITY_BILLBANK_STATEMENTTAX_CERTIFICATECERTIFICATE_OF_INCORPORATIONREGISTRY_EXTRACTARTICLES_OF_ASSOCIATIONSHAREHOLDER_REGISTERDIRECTOR_REGISTERUBO_DECLARATIONPOWER_OF_ATTORNEYBOARD_RESOLUTIONREGULATORY_LICENSEBUSINESS_LICENSEFINANCIAL_STATEMENTAUDIT_REPORTSOURCE_OF_FUNDSINVOICECONTRACTPURCHASE_ORDERPAYROLL_FILELOAN_AGREEMENTSHIPPING_DOCUMENTCUSTOMS_DECLARATIONOTHER

SupportingDocumentInput

object
#

A document supporting the payment, such as an invoice or contract. One item is one file of up to 10 MB in PDF, JPEG or PNG format; supply the file content as base64.

documentTypeRequired
SupportingDocumentType
dataRequired
string

Complete file encoded as base64 from its raw bytes. Do not include a data-URL prefix.

nameRequired
string

File name, including the extension.

Min length1Max length255

SupportingDocument

object
#

Metadata of a document accepted with the payment. File content is not returned.

documentTypeRequired
SupportingDocumentType
fileIdRequired
string

Identifier of the stored file.

Formatuuid
nameRequired
string

File name supplied with the document.

contentTypeRequired
string

MIME type detected from the file content.

sizeRequired
integer

File size in bytes.

ClientEventData

object
#

Client record snapshot at the time of the event. Fetch `GET /clients/{clientId}` when current profile details are required.

clientIdRequired
string
Formatuuid
code
string

Human-readable Axiym client code, where available.

legalEntityNameRequired
string
paymentRailsRequired
string
currencyRequired
string
statusRequired
string

ClientStatusEventData

object
#

Compact client availability change. Fetch `GET /clients/{clientId}` when current profile details are required.

clientIdRequired
string

Axiym identifier of the represented client.

Formatuuid
statusRequired
string

Client availability at the time the event was emitted.

Allowed values
ACTIVEDISABLED

ClientOnboardingEventData

object
#

Compact outcome of a client onboarding review. Fetch `GET /onboardings/{clientId}` for the authoritative case, including any available rejection reason.

clientIdRequired
string

Axiym identifier assigned to the represented client.

Formatuuid
partnerClientIdRequired
string

Your stable identifier for the client.

statusRequired
string

Terminal onboarding decision.

Allowed values
ACTIVEREJECTED

WithdrawalEventStatus

string
#

Statuses that appear in withdrawal events. `PENDING_CONFIRMATION` never does: events start with `withdrawal.created` once the withdrawal is confirmed.

Allowed values
PENDINGHELDCOMPLETEDCANCELEDREJECTED

WithdrawalEventData

object
#

A compact notification for routing and correlation. Retrieve the withdrawal from `GET /clients/{clientId}/withdrawals/{withdrawalId}` when you need its amount, fees, transaction hash, or current state.

withdrawalIdRequired
string

Withdrawal identifier (UUID).

Formatuuid
statusRequired
WithdrawalEventStatus

Withdrawal status at the time the event was emitted.

externalReference
ExternalReference

Your reference submitted on creation, where present.

reasonCode
string

Present on `withdrawal.canceled` / `withdrawal.rejected` — the reason as reported by the bank, the network, or Axiym operations. Example: `INSUFFICIENT_BENEFICIARY_DETAILS`.

clientIdRequired
string

Axiym identifier of the client that owns the resource.

Formatuuid

AccountMovementEventData

object
#

A posted account movement. The event includes the movement amount but not the current balance. Retrieve the account when you need its latest balance.

accountIdRequired
string

Account identifier (UUID).

Formatuuid
amountRequired
Decimal

Positive movement amount in the account currency; direction is in the event type.

currencyRequired
Currency

Account currency.

relatedResourceType
string

Type of the linked money movement; absent for movements with no linked API resource.

Allowed values
DEPOSITWITHDRAWALCONVERSIONPAYOUTTRANSFER
relatedResourceId
string

Identifier of the linked resource, where present.

Formatuuid
occurredAtRequired
string

When the movement occurred. Formatted in ISO 8601.

Formatdate-time
clientIdRequired
string

Axiym identifier of the client that owns the resource.

Formatuuid

AccountStatusEventData

object
#

Account lifecycle notification.

accountIdRequired
string

Account identifier (UUID).

Formatuuid
statusRequired
AccountStatus

Account status at the time the event was emitted.

clientIdRequired
string

Axiym identifier of the client that owns the resource.

Formatuuid

DestinationEventData

object
#

Notification about the review or availability of an external account registered in the selected client's address book. `destinationId` identifies its address book entry.

destinationIdRequired
string

Identifier of the external account in the selected client's address book (UUID).

Formatuuid
statusRequired
DestinationStatus

External account status at the time the event was emitted.

clientIdRequired
string

Axiym identifier of the client whose address book contains the external account.

Formatuuid

Event

object
#

Webhook event envelope delivered to your registered endpoint.

idRequired
string

Unique event identifier. Repeated deliveries of the same event carry the same `id`; use it to avoid processing the event more than once.

Formatuuid
timestampRequired
string

Event timestamp. Formatted in ISO 8601.

Formatdate-time
typeRequired
string

Event type.

dataRequired
object

Event data.

Subscription

object
#
subscriptionIdRequired
string

Subscription identifier (UUID).

Formatuuid
endpointRequired
string

URL of the endpoint to subscribe to notifications. Must be publicly accessible, use HTTPS, and respond with a 2XX status to a POST request.

Formaturi

RequestStatus

object
#
statusRequired
string

`OK` means the test delivery request was accepted. It does not confirm successful delivery or processing by your endpoint.

Allowed values
OK

Default OK

PublicKey

object
#
publicKeyIdRequired
string

Public key identifier (UUID).

Formatuuid
activeRequired
boolean

Indicates whether the key is active.

algorithmRequired
string

Signature algorithm associated with the public key.

publicKeyRequired
string

Base64-encoded DER SubjectPublicKeyInfo (SPKI) public key used to verify webhook signatures.

createdAtRequired
string

Creation timestamp. Formatted in ISO 8601.

Formatdate-time

Money

object
#

Monetary amount and its currency.

amountRequired
Decimal
currencyRequired
Currency

Decimal

string
#

Decimal number serialized as a string to preserve precision. Amounts sent to Axiym are positive and carry at most 8 decimal places.

ExternalReference

string
#

Your optional identifier for correlating the resource with your system. Axiym returns it on reads. It does not make retries safe; use `Idempotency-Key` for that.

Max length255

ValidationFieldErrors

ValidationError[] | object
#

Nested validation errors keyed by field name or array index. Leaf values are arrays of `ValidationError` objects.

One of

Network

string
#

Wallet network.

Allowed values
TRONAVALANCHE

ValidationError

object
#

One field-level validation error.

codeRequired
string

Identifier of the validation rule that failed, such as `length` or `invalid_currency`.

message
string | null

Human-readable message.

paramsRequired
object

Rule-specific parameters. Always includes `value` (the offending input). Additional keys depend on the rule (e.g. `min`, `max` for length).

value
unknown

The submitted value that failed validation.