---
title: "Retrieve your wallet transactions"
method: GET
path: "/api/v1/wallet-transactions"
tags: ["Wallet Transactions"]
---

# Retrieve your wallet transactions

`GET /api/v1/wallet-transactions`

Required scope: `wallet-transactions:read` </br>Organization authorization: `supported`

## Query parameters

- `page` integer
- `perPage` integer
- `operatorId` integer, nullable — Filter to retrieve transactions for a given operator.</br>*Note:*The operatorId must be in the consumer’s operatorIds or, if empty, belong to the organization’s sub-operators.</br>*Note*: When not provided the default operator will be used for the given consumer, if the default operator cannot be assigned the request will be rejected
- `teamId` integer, nullable — Filter to retrieve transactions for a given team.</br>*Note*: When not provided the transactions for the operator will be returned instead
- `fromDate` string, date-time, nullable — Filter to retrieve transactions where `createdAt` >= `fromDate` (ISO8601: yyyy-MM-ddTHH:mm:ssZ)
- `toDate` string, date-time, nullable — Filter to retrieve transactions where `createdAt` <= `toDate` (ISO8601: yyyy-MM-ddTHH:mm:ssZ)
- `referenceId` string, nullable — Filter to retrieve transactions by the matching referenceId
- `referenceType` 'TEAM' | 'COMPANY_REFERRAL' | 'USER_REFERRAL' | 'ORDER' | 'SUBSCRIPTION_PURCHASE' | 'CHARGE' | 'BANK_ACCOUNT' | 'WALLET_BANK_ACCOUNT' | 'STRIPE_CHARGE' | 'SUBSCRIPTION' | 'TRANSACTION' | 'PROMO_CODE_USE' | 'TEAM_MEMBER_FEE_PURCHASE' | 'WALLET' | 'PAYTER_PAYMENT_SESSION' | 'ADYEN_PAYMENT' | 'POWER_BANK_PAYOUT' | 'SPLIT_BILLING_SETTLEMENT' | 'OTHER', nullable — Filter to retrieve transactions by the matching referenceType
- `state` 'complete' | 'pending' | 'failed' | 'reserved' | 'other', nullable — Filter to retrieve transactions by the matching state
- `group` 'deposit' | 'withdraw' | 'charge' | 'other', nullable — Filter to retrieve transactions by the matching group
- `partnerExternalId` string, nullable — **Note: This has been deprecated and won't do anything moving forward.**Filter transactions by partnerExternalId, to filter only resources without `partnerExternalId` *use* `partnerExternalId=""`

## Response `200`

List of wallet transactions that match the criteria

- OffsetBasedResponse30
  - `data` WalletTransaction[], required
    - `id` integer — Id of the transaction
    - `fromAmount` number, double — Amount sent, incl. VAT
    - `fromSubAmount` number, double — Amount sent, excl. VAT
    - `fromVatAmount` number, double — VAT amount sent
    - `fromCurrency` Currency1, required
      - `identifier` string, required — Currency identifier, e.g. dkk
      - `name` string, required — Readable name of currency
      - `decimals` integer — Number of decimals for this currency
    - `fromType` string, nullable — Type of sender: operator, team
    - `from` union
      - object
        - `id` integer — ID of the operator
        - `name` string, required — Name of operator
        - `identifier` string, required — Identifier of operator
        - `partnerId` integer, nullable — Id of the partner
        - `vatNumber` string, nullable — VAT number
      - object
        - `id` integer — Id of the paying team
        - `publicName` string, required — Public name of the team
        - `operatorId` integer — Id of the operator the paying team belongs to
    - `fromWalletId` integer, nullable — Id of the wallet where the amount was sent from. Can be `null` if the transaction did not originate from a wallet.
    - `toAmount` number, double — Amount received, incl. VAT
    - `toSubAmount` number, double — Amount received, excl. VAT
    - `toVatAmount` number, double — VAT amount received
    - `toCurrency` Currency1, required
      - `identifier` string, required — Currency identifier, e.g. dkk
      - `name` string, required — Readable name of currency
      - `decimals` integer — Number of decimals for this currency
    - `toType` string, nullable — Type of receiver: operator, team
    - `to` union
      - object
        - `id` integer — ID of the operator
        - `name` string, required — Name of operator
        - `identifier` string, required — Identifier of operator
        - `partnerId` integer, nullable — Id of the partner
        - `vatNumber` string, nullable — VAT number
      - object
        - `id` integer — Id of the paying team
        - `publicName` string, required — Public name of the team
        - `operatorId` integer — Id of the operator the paying team belongs to
    - `toWalletId` integer, nullable — Id of the wallet where the amount was sent to. Can be `null` if the transaction did not target a wallet.
    - `exchangeRate` number, double — Exchange rate used for currency conversion
    - `createdAt` string, date-time, required — Creation date of transaction
    - `updatedAt` string, date-time, nullable — Update date of transaction
    - `completedAt` string, date-time, nullable — Completion date of transaction
    - `referenceId` string, nullable — Reference id of this transaction. e.g the charge id
    - `referenceType` 'TEAM' | 'COMPANY_REFERRAL' | 'USER_REFERRAL' | 'ORDER' | 'SUBSCRIPTION_PURCHASE' | 'CHARGE' | 'BANK_ACCOUNT' | 'WALLET_BANK_ACCOUNT' | 'STRIPE_CHARGE' | 'SUBSCRIPTION' | 'TRANSACTION' | 'PROMO_CODE_USE' | 'TEAM_MEMBER_FEE_PURCHASE' | 'WALLET' | 'PAYTER_PAYMENT_SESSION' | 'ADYEN_PAYMENT' | 'POWER_BANK_PAYOUT' | 'SPLIT_BILLING_SETTLEMENT' | 'OTHER'
    - `group` 'deposit' | 'withdraw' | 'charge' | 'other', required — Transaction group of this transaction
    - `kind` string, required — Kind of this transaction, ie 'charge-sponsored'.<br/>**Note:** This is an open field and therefore more kinds will be added moving forward.
    - `vatPercentage` number, double — VAT percentage included in this transaction.
    - `state` 'complete' | 'pending' | 'failed' | 'reserved' | 'other', required — Transaction state of this transaction
    - `note` string, nullable — A note that has been entered for this transaction.
    - `partnerExternalId` string, nullable — **Note: This has been deprecated and will be null always.**External Id of this entity, managed by you.
    - `partnerCustomPayload` object[], nullable — **Note: This has been deprecated and will be null always.**Custom JSON payload for this entity, managed by you.
    - `metadata` union
      - object
        - `id` integer — The id of the the tax refund
        - `kwh` number, double — The total kwh for the tax refund
        - `type` 'tax-refund-metadata' | 'charge-metadata' | 'default-metadata', required
        - `chargeId` integer, nullable — The reference to chargeId for the tax refund
      - object
        - `id` integer — The id of the the charge
        - `kwh` number, double — The total kwh for the charge
        - `type` 'tax-refund-metadata' | 'charge-metadata' | 'default-metadata', required
  - `meta` MontaPageMeta, required
    - `itemCount` integer, required
    - `currentPage` integer, required
    - `perPage` integer, required
    - `totalPageCount` integer, required
    - `totalItemCount` integer, required

## Other responses

- `400` — The request is invalid
- `401` — Consumer with provided credentials was not found
- `403` — Operator doesn't have access to resource
- `404` — Entity with the provided id was not found

---

[API](https://skmtc.net/monta/apis/monta-partner-api.md) · [All operations](https://skmtc.net/monta/apis/monta-partner-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/monta/monta-partner-api/versions/517e18f11015/schema)