Skip to main content
Weavr API
Reference

Parameters

idempotency-ref

idempotency-refheader

A unique call reference generated by the caller that, taking into consideration the payload as well as the operation itself, helps avoid duplicate operations. Idempotency reference uniqueness is maintained for at least 24 hours.

string
Example
transfer-2026-08-07-001
transfer-2026-08-07-001

channel

channelpath*

The unique identifier for the channel.

SCAOtpChannel · enum
  • SMS: The one-time-password is sent as a text message

Enum:SMS

scaPushChannel

channelpath*

The push channel used to deliver the SCA challenge.

SCAPushChannel · enum
  • AUTHY: The push notification is sent on the user's device using Twilio Authy
  • BIOMETRIC: The push notification is sent to the user's device

Enum:AUTHYBIOMETRIC

userId

user_idpath*

The unique identifier for the user.

UserId · string

pattern ^[0-9]+$

Example
987654321
987654321

authFactorsPushChannel

channelpath*

The push channel used for the authentication factor.

AuthSCAPushChannel · enum
  • AUTHY: The push notification is sent on the user's device using Twilio Authy

Enum:AUTHY

offset

offsetquery

The offset value for paging, indicating the initial item number to be returned from the data set satisfying the given criteria. Leave out to fetch the first page of results.

integer · int32

min 0

Example
0
0

limit

limitquery

The limit of the results for paging, starting at the offset. Limit is always capped at 100.

integer · int32

min 1max 100

Example
25
25

active

activequery

Filter for active or deactivated users. Leave out to fetch all users.

boolean

tag

tagquery

Filter by the managed account/card tag. The exact tag must be provided, as wildcards are not supported. Leave out to fetch all managed accounts/card.

string

bulkProcessStatus

statusquery

Filter by the bulk process status.

BulkProcessStatus · enum

The current status of the bulk process:

  • SUBMITTED: The bulk process data has been persisted and is ready for execution. This is the initial state.
  • RUNNING: The bulk process is currently being executed.
  • PARTIALLY_COMPLETED: Execution is complete, but some bulk operations failed. This is a final state.
  • COMPLETED: Execution is complete, and all bulk operations succeeded. This is a final state.
  • FAILED: No operations in the bulk process were executed. This is a final state.
  • PAUSED: Execution has been paused and can be resumed.
  • CANCELLED: Execution has been cancelled. This is a final state.

Enum:SUBMITTEDRUNNINGPARTIALLY_COMPLETEDCOMPLETEDFAILEDPAUSEDCANCELLED

bulkId

bulk_idpath*

The bulk id of the bulk process.

BulkId · string

pattern ^[0-9]+$

Example
2468013579
2468013579

sequence

sequencequery

Return bulk process operations at or after this sequence number.

integer · int64

bulkProcessOperationStatus

statusquery

Filter by the bulk process operation status.

BulkProcessOperationStatus · enum

Enum:SUBMITTEDRUNNINGCOMPLETEDFAILEDCANCELLED

userIdExplode

user_idpath*

The unique identifier for the user.

UserId · string

pattern ^[0-9]+$

Example
987654321
987654321

creationTimestampFrom

creationTimestampFromquery

Filter for transactions created after this timestamp. Epoch timestamp using millisecond precision.

integer · int64

creationTimestampTo

creationTimestampToquery

Filter for transactions created before this timestamp. Epoch timestamp using millisecond precision.

integer · int64

sortOrder

sortOrderquery

Sort order for the results:

  • ASC: Ascending order, oldest first.
  • DESC: Descending order, most recent first.
enum

Enum:ASCDESC

profileId

profileIdquery

Filter by the managed account/card profile. Leave out to fetch all managed accounts/card.

ProfileId · string

The profile Id which a specific identity, instrument or transaction type is linked to.

Profiles contain configuration and determine behavioral aspects of the newly created transaction, for example, fees that may apply.

You can have one or more profiles linked to your application, and these can be used to drive different behaviors according to your product's needs.

Profile Ids can be found in the Multi Portal, in the API Credentials page.

pattern ^[0-9]+$

Example
10001
10001

friendlyName

friendlyNamequery

Filter by the managed account/card friendly name. Leave out to fetch all managed accounts/card.

The exact name must be provided, as wildcards are not supported.

string

min length 1max length 50

state

statequery

Filter by one or more current instrument states. When multiple values are provided, instruments matching any of the states are returned:

  • ACTIVE: The instrument can be used in transactions.
  • BLOCKED: The instrument is temporarily blocked and cannot be used.
  • DESTROYED: The instrument has been permanently destroyed.
  • NOT_ENABLED: The instrument cannot be used because its linked user has not completed the required verification steps.

Leave this parameter out to return instruments in any state.

array<InstrumentState · enum>

Enum:ACTIVEBLOCKEDDESTROYEDNOT_ENABLED

unique items true

currency

currencyquery

Filter by the managed account/card currency.

Currencies are expressed as an ISO 4217 code. Leave out to fetch all managed accounts/card.

Currency · string

The currency expressed in ISO-4217 code. Example: GBP, EUR, USD.

min length 3max length 3pattern ^[A-Z]*$

Example
GBP
GBP

createdFrom

createdFromquery

Filter for managed accounts/cards created after createdFrom timestamp. Timestamp is expressed in Epoch timestamp using millisecond precision. Leave out to fetch all managed accounts/cards.

integer · int64
Example
1767225600000
1767225600000

createdTo

createdToquery

Filter for managed accounts/cards created before createdTo timestamp. Timestamp is expressed in Epoch timestamp using millisecond precision. Leave out to fetch all managed accounts/cards.

integer · int64
Example
1769903999999
1769903999999

verificationRunState

statequery

Filter by one or more linked-account verification run states.

array<LinkedAccountVerificationRunState · enum>

Enum:PENDINGVERIFIEDREJECTED

unique items true

state_blockedReason

state.blockedReasonquery

Filter blocked instruments by one or more reasons they were blocked. When multiple values are provided, instruments matching any of the reasons are returned. This filter applies only to instruments whose state is BLOCKED.

Leave this parameter out to return blocked instruments regardless of the reason.

array<BlockedReason · enum>

Enum:USERSYSTEMLOSTSINGLE_SPEND

unique items true

state_destroyedReason

state.destroyedReasonquery

Filter destroyed instruments by one or more reasons they were destroyed. When multiple values are provided, instruments matching any of the reasons are returned. This filter applies only to instruments whose state is DESTROYED.

Leave this parameter out to return destroyed instruments regardless of the reason.

array<DestroyedReason · enum>

Enum:SYSTEMUSERLOSTSTOLENEXPIREDCOMPROMISEDSINGLE_SPEND

unique items true

accept

acceptheader

A request parameter specifying the type of response the client would like. Must be one of application/json, application/pdf or text/csv.

The default response type (application/json) will be returned if specified incorrectly or not specified.

enum

Enum:application/jsontext/csvapplication/pdf

Example
application/json
application/json

statementLimit

statementLimitquery

The limit of the results for statements paging, starting at the offset. Limit is capped at 500.

integer · int32

min 1max 500

orderByTimestamp

orderByTimestampquery

Orders the result in ascending or descending order.

  • ASC: Ascending order, oldest transactions first.
  • DESC: Descending order, most recent transactions first.

If not specified, the transactions will be returned in descending order.

enum

Enum:ASCDESC

fromTimestamp

fromTimestampquery

Filter for transactions having transaction timestamp after fromTimestamp. Timestamp is expressed in Epoch timestamp using millisecond precision. If omitted, all matching transactions up to the present will be included.

integer · int64

toTimestamp

toTimestampquery

Filter for transactions having transaction timestamp before toTimestamp. Timestamp is expressed in Epoch timestamp using millisecond precision. If omitted, all matching transactions up to the present will be included. If both fromTimestamp and toTimestamp are provided, toTimestamp must be greater than fromTimestamp.

integer · int64

showFundMovementsOnly

showFundMovementsOnlyquery

Deprecated. Use singleEntryPerTransaction instead.

Returns only the entries which contain fund movements.

boolean

singleEntryPerTransaction

singleEntryPerTransactionquery

Returns transactions that span multiple movements as a single entry. Only includes transactions that have been completed. Defaults to true for PDF statements, false otherwise. Note: due to the fact that only completed transactions are included, some transactions that are in progress and have modified the balance of the instrument will not be shown, which could lead to seemingly inconsistent balance being displayed.

boolean

statementTransactionType

transactionTypequery

Filter by the transaction type. Leave out to fetch all entries.

array<StatementTransactionType · enum>

Enum:AUTHORISATIONSETTLEMENTMANUAL_TRANSACTIONTRANSFERSENDDEPOSITAUTHORISATION_REVERSALAUTHORISATION_EXPIRYAUTHORISATION_DECLINEAUTHORISATION_MANUAL_CLOSEMERCHANT_REFUNDMERCHANT_REFUND_REVERSALORIGINAL_CREDIT_TRANSACTIONSETTLEMENT_REVERSALADJUSTMENTCHARGE_FEEWITHDRAWAL_RESERVEWITHDRAWAL_RELEASEFEE_REVERSALOUTGOING_WIRE_TRANSFERAUTHORISATION_CANCELLATIONSYSTEM_TRANSACTIONOUTGOING_DIRECT_DEBIT_COLLECTIONOUTGOING_DIRECT_DEBIT_REFUNDCORRESPONDENT_BANK_TRANSFER

unique items true

apiVersion

x-api-versionheader

Opts the call in to the latest version of the endpoint. Set to LATEST to be routed to the newest implementation; omit to retain the default routing for your tenant.

enum

Enum:LATEST

statementResponseLimit

limitquery

The maximum number of statement entries to return. Limit is capped at 500.

integer · int32

min 1max 500

startPeriod

startPeriodquery

Start of the statement period. Epoch timestamp using millisecond precision.

integer · int64

endPeriod

endPeriodquery

End of the statement period. Epoch timestamp using millisecond precision.

integer · int64

statementSortOrder

sortOrderquery

Sort order for the results:

  • ASC: Ascending order, oldest first (default for statements).
  • DESC: Descending order, most recent first.
InstrumentStatementSortOrder · enum

Enum:ASCDESC

statementResponseTransactionType

transaction.typequery

Filter statement entries by one or more transaction types.

array<StatementResponseEntryTransactionType · enum>

Enum:card_paymentstransferssendsoutgoing_wire_transfersincoming_wire_transferscorrespondent_bank_transfersfeessystem_transactions

unique items true

statementResponseExecutingAccessInstrumentId

executingAccessInstrument.idquery

Filter statement entries by the ID of the access instrument that initiated the transaction.

string

pattern ^[0-9]+$

statementResponseExecutingAccessInstrumentType

executingAccessInstrument.typequery

Filter statement entries by the type of access instrument that initiated the transaction (managed cards or IBANs).

array<AccessInstrumentType · enum>

Enum:managed_cardsibans

unique items true

transactionActivityType

typequery

Filter by one or more transaction activity types.

array<TransactionActivityType · enum>

Enum:transferssendsoutgoing_wire_transferscorrespondent_bank_transfersincoming_wire_transferscard_paymentsfeessystem_transactions

transactionActivityStatus

statusquery

Filter by one or more normalised transaction statuses.

array<TransactionActivityStatus · enum>

Enum:DRAFTSUBMITTEDPROCESSINGCOMPLETEDCANCELLEDRETURNED

transactionActivityDirection

directionquery

Filter by transaction direction (CREDIT or DEBIT).

TransactionActivityDirection · enum

Whether funds were credited to or debited from the instrument.

Enum:CREDITDEBIT

lastUpdatedTimestampFrom

lastUpdatedTimestampFromquery

Filter for transactions last updated after this timestamp. Useful for pulling recently changed transactions. Epoch timestamp using millisecond precision.

integer · int64

lastUpdatedTimestampTo

lastUpdatedTimestampToquery

Filter for transactions last updated before this timestamp. Epoch timestamp using millisecond precision.

integer · int64

transactionActivitySortBy

sortByquery

The field to sort transaction activity results by. Defaults to creationTimestamp.

TransactionActivitySortBy · enum

The field to sort transaction activity results by:

  • creationTimestamp: Sort by when the transaction was first created (default).
  • lastUpdatedTimestamp: Sort by when the transaction was most recently updated.

Enum:creationTimestamplastUpdatedTimestamp

card_type

typequery

Filter by the type of the card.

enum

Enum:VIRTUALPHYSICAL

card_renewal_type

renewalTypequery

Filter by the renewal type of the card.

enum

Enum:RENEWNO_RENEW

userIdQuery

userIdquery

The unique identifier for the user.

UserId · string

pattern ^[0-9]+$

Example
987654321
987654321

cardPaymentCardId

cardIdquery

Filter by the managed card the payment belongs to.

string

pattern ^[0-9]+$

cardPaymentStatus

statusquery

Filter by one or more card payment statuses.

array<CardPaymentStatus · enum>

Enum:SETTLEMENT_IN_PROGRESSSETTLEDDECLINEDCANCELLEDEXPIRED

cardPaymentType

typequery

Filter by one or more card payment types.

array<CardPaymentType · enum>

Enum:PURCHASEREFUNDORIGINAL_CREDITACCOUNT_FUNDINGCASH_WITHDRAWALBALANCE_INQUIRY

cardPaymentSubtype

subtypequery

Filter by one or more event subtypes (joined against the events timeline).

array<CardPaymentSubtype · enum>

Enum:sale_purchasescash_withdrawalssales_with_cashbackmail_or_telephone_ordersaccount_fundingpurchase_reversalscash_withdrawal_reversalspurchase_refundspurchase_refund_reversalsoriginal_credit_transactionsoriginal_credit_transaction_reversals

cardPaymentMerchantName

merchantNamequery

Partial, case-insensitive match against merchant name.

string

cardPaymentAmountFrom

amountFromquery

Filter for displayAmount.amount >= amountFrom.

integer · int64

cardPaymentAmountTo

amountToquery

Filter for displayAmount.amount <= amountTo.

integer · int64

cardPaymentCreationTimestampFrom

creationTimestampFromquery

Filter for card payments created at or after this epoch timestamp in milliseconds.

integer · int64

cardPaymentCreationTimestampTo

creationTimestampToquery

Filter for card payments created before this epoch timestamp in milliseconds.

integer · int64

cardPaymentLastUpdatedTimestampFrom

lastUpdatedTimestampFromquery

Filter for card payments updated at or after this epoch timestamp in milliseconds.

integer · int64

cardPaymentLastUpdatedTimestampTo

lastUpdatedTimestampToquery

Filter for card payments updated before this epoch timestamp in milliseconds.

integer · int64

cardPaymentSortOrder

sortOrderquery

Sort order on creationTimestamp. ASC = oldest first.

enum

Enum:ASCDESC

cardPaymentId

idpath*

The unique identifier of a card payment.

string

pattern ^[0-9]+$

cardPaymentEventCardPaymentId

cardPaymentIdquery

Filter events to a single card payment.

string

pattern ^[0-9]+$

cardPaymentEventCardId

cardIdquery

Filter events to those on a single managed card.

string

pattern ^[0-9]+$

cardPaymentEventType

typequery

Filter by one or more event types.

array<CardPaymentEventType · enum>

Enum:AUTHORISATIONSETTLEMENTREFUNDORIGINAL_CREDIT

cardPaymentEventSubtype

subtypequery

Filter events by one or more network subtypes.

array<CardPaymentSubtype · enum>

Enum:sale_purchasescash_withdrawalssales_with_cashbackmail_or_telephone_ordersaccount_fundingpurchase_reversalscash_withdrawal_reversalspurchase_refundspurchase_refund_reversalsoriginal_credit_transactionsoriginal_credit_transaction_reversals

cardPaymentEventReversal

reversalquery

Filter events by reversal flag.

boolean

cardPaymentEventTimestampFrom

timestampFromquery

Filter for card payment events at or after this epoch timestamp in milliseconds.

integer · int64

cardPaymentEventTimestampTo

timestampToquery

Filter for card payment events before this epoch timestamp in milliseconds.

integer · int64

cardPaymentEventSortOrder

sortOrderquery

Sort order on event timestamp. ASC = oldest first (default DESC).

enum

Enum:ASCDESC

transferProfileId

profileIdquery

Filter by the transfer profile. Leave out to fetch all transfer transactions.

ProfileId · string

The profile Id which a specific identity, instrument or transaction type is linked to.

Profiles contain configuration and determine behavioral aspects of the newly created transaction, for example, fees that may apply.

You can have one or more profiles linked to your application, and these can be used to drive different behaviors according to your product's needs.

Profile Ids can be found in the Multi Portal, in the API Credentials page.

pattern ^[0-9]+$

Example
10001
10001

instrumentId

instrumentIdquery

Filter by the source instrument id.

{}
InstrumentIdInstrumentId · object · 2 fields
{
  "id": "123456789",
  "type": "managed_accounts"
}

transactionState

statequery

Filter by the transfer transaction state. Leave out to fetch all states.

array<TransactionState · enum>

Enum:INITIALISEDCOMPLETEDREJECTEDFAILEDPENDINGSCHEDULEDCANCELLED

unique items true

transferCreatedFrom

createdFromquery

Filter for transfer transactions created after createdFrom timestamp. Timestamp is expressed in Epoch timestamp using millisecond precision. Leave out to fetch all transfers.

integer · int64

transferCreatedTo

createdToquery

Filter for transfer transactions created before createdTo timestamp. Timestamp is expressed in Epoch timestamp using millisecond precision. Leave out to fetch all transfers.

integer · int64

transferExecutedFrom

executedFromquery

Filter for transfer transactions executed after executedFrom timestamp. Timestamp is expressed in Epoch timestamp using millisecond precision. Leave out to fetch all transfers.

integer · int64

transferExecutedTo

executedToquery

Filter for transfer transactions executed before executedTo timestamp. Timestamp is expressed in Epoch timestamp using millisecond precision. Leave out to fetch all transfers.

integer · int64

transferTag

tagquery

Filter by the transfer tag. The exact tag must be provided, as wildcards are not supported. Leave out to fetch all entries.

string

sendProfileId

profileIdquery

Filter by the Send profile. Leave out to fetch all entries.

ProfileId · string

The profile Id which a specific identity, instrument or transaction type is linked to.

Profiles contain configuration and determine behavioral aspects of the newly created transaction, for example, fees that may apply.

You can have one or more profiles linked to your application, and these can be used to drive different behaviors according to your product's needs.

Profile Ids can be found in the Multi Portal, in the API Credentials page.

pattern ^[0-9]+$

Example
10001
10001

sourceId

source.idquery

Filter by the source instrument id. Must be specified when source.type is provided.

Id · string

pattern ^[0-9]+$

Example
123456789
123456789

sourceType

source.typequery

Filter by the source instrument type. Must be specified when source.id is provided.

InstrumentType · enum

Enum:managed_cardsmanaged_accounts

sendState

statequery

Filter by the Send transaction state. Leave out to fetch all states.

array<SendState · enum>

Enum:INVALIDINITIALISEDCOMPLETEDREJECTEDFAILEDPENDINGPENDING_CHALLENGEAPPROVEDRETURNEDSCHEDULEDCANCELLED

unique items true

sendCreatedFrom

createdFromquery

Filter for send transactions created after createdFrom timestamp. Timestamp is expressed in Epoch timestamp using millisecond precision. Leave out to fetch all Send transactions.

integer · int64

sendCreatedTo

createdToquery

Filter for send transactions created before createdTo timestamp. Timestamp is expressed in Epoch timestamp using millisecond precision. Leave out to fetch all Send transactions.

integer · int64

sendExecutedFrom

executedFromquery

Filter for send transactions executed after executedFrom timestamp. Timestamp is expressed in Epoch timestamp using millisecond precision. Leave out to fetch all Send transactions.

integer · int64

sendExecutedTo

executedToquery

Filter for send transactions executed before executedTo timestamp. Timestamp is expressed in Epoch timestamp using millisecond precision. Leave out to fetch all Send transactions.

integer · int64

sendTag

tagquery

Filter by the send tag. The exact tag must be provided, as wildcards are not supported. Leave out to fetch all entries.

string

iwtState

statequery

Filter incoming wire transfers by state.

array<IncomingWireTransferMultiState · enum>

Enum:PENDINGCOMPLETEDREJECTED

sourceInstrument_id

sourceInstrument.idquery

Filter by the source instrument id. Must be specified when source.type is provided.

Id · string

pattern ^[0-9]+$

Example
123456789
123456789

sourceInstrument_type

sourceInstrument.typequery

Filter by the source instrument type. Must be specified when source.id is provided.

SourceInstrumentType · enum

Enum:managed_accounts

owtState

statequery

Filter by the outgoing wire transfer state. Leave out to fetch all states.

array<OutgoingWireTransferState · enum>

Enum:INVALIDPENDING_CHALLENGESUBMITTEDREJECTEDAPPROVEDFAILEDCOMPLETEDRETURNEDSCHEDULEDDEFERREDCANCELLEDPENDING_CONFIRMATION

unique items true

request-ref

request-refheader

A unique call reference included in every call, that enables the receiver to avoid duplicate handling of a webhook request (e.g. webhook was resent).

string
Example
req-7f3e2b1a
req-7f3e2b1a

published-timestamp

published-timestampheader*

The timestamp, expressed in Epoch timestamp using millisecond precision, when this event was published.

integer · int64

signature

signatureheader*

The signature to verify the authenticity of this request. This is the base64 hash (HmacSHA256) of the published-timestamp using your API key.

string

signature-v2

signature-v2header*

The signature to verify the authenticity of this request. This is the base64 hash (HmacSHA256) of the call-ref + payload + published-timestamp using your API key.

string

call-ref

call-refheader

A call reference generated by the caller and unique to the caller to provide correlation between the caller and system with a maximum length of 255

string