Skip to content

Transaction Activity

Retrieve the consolidated transaction activity across instruments.

Operations

Get all transaction activity

Request

Returns all transactional activity across all managed accounts and managed cards.

This provides a single view of all transfers, sends, wire transfers, card payments, fees, and other transaction types regardless of which wallet they belong to.

creationTimestamp is when the transaction was created in its owning service (the same value the nested transaction object reports), and is the field the creation-window filter applies to. Transactions that are committed but not yet executed (e.g. scheduled wire transfers) appear with status SUBMITTED; such transactions never appear on statements until they execute.

A transfer between two of the caller's own instruments (e.g. between a managed account and a managed card belonging to the same identity) returns two entries — a DEBIT on the source instrument and a CREDIT on the destination instrument — which share the same id and differ by instrument. Treat (id, instrument) as the key when reconciling, and note that such a transfer contributes 2 to the count. The per-instrument activity endpoints (/managed_accounts/{id}/transactions, /managed_cards/{id}/transactions) are scoped to one instrument and so still show the single relevant side.

Security
auth_token and api-key
Query
offsetinteger, (int32), >= 0

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.

limitinteger, (int32), [ 1 .. 100 ]

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

typeArray of strings

Filter by one or more transaction activity types.

statusArray of strings

Filter by one or more normalised transaction statuses.

directionstring(TransactionActivityDirection)

Filter by transaction direction (CREDIT or DEBIT).

Enum:"CREDIT""DEBIT"
creationTimestampFrominteger, (int64)

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

creationTimestampTointeger, (int64)

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

lastUpdatedTimestampFrominteger, (int64)

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

lastUpdatedTimestampTointeger, (int64)

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

sortOrderstring

Sort order for the results:

  • ASC: Ascending order, oldest first.
  • DESC: Descending order, most recent first.
Enum:"ASC""DESC"
sortBystring(TransactionActivitySortBy)

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

Enum:"creationTimestamp""lastUpdatedTimestamp"
curl -i -X GET \
  'https://sandbox.weavr.io/multi/transactions?offset=0&limit=1&type=transfers&status=DRAFT&direction=CREDIT&creationTimestampFrom=0&creationTimestampTo=0&lastUpdatedTimestampFrom=0&lastUpdatedTimestampTo=0&sortOrder=ASC&sortBy=creationTimestamp' \
  -H 'Authorization: Bearer <YOUR_JWT_HERE>' \
  -H 'api-key: YOUR_API_KEY_HERE'

Responses

Success

Headers
request-refstringrequired

A request identifier. Providing this reference when contacting our support team will help us investigate your query.

Bodyapplication/json
transactionsArray of objects(TransactionActivityItem)
countinteger, (int64)

The total number of records matching the filter criteria.

responseCountinteger, (int64)
Response
{
  "transactions": [
    { … }
  ],
  "count": 0,
  "responseCount": 0
}