---
updatedAt: 2026-04-28T14:28:22.000Z
agentTools:
  projectIndex: https://monta-public-api.readme.io/llms.txt
---

# Retrieve a list of wallet transactions.

Required scope: `wallet-transactions`

# OpenAPI definition

```json
{
  "openapi": "3.0.1",
  "info": {
    "title": "MONTA Public API",
    "description": "\n            see https://docs.public-api.monta.com\n        ",
    "contact": {
      "name": "Discuss",
      "url": "https://docs.public-api.monta.com/discuss"
    },
    "version": "2023-09-14"
  },
  "servers": [
    {
      "url": "https://public-api.monta.com",
      "description": "Production"
    }
  ],
  "paths": {
    "/api/v1/wallet-transactions": {
      "get": {
        "tags": [
          "Wallet Transactions"
        ],
        "summary": "Retrieve a list of wallet transactions.",
        "description": "Required scope: `wallet-transactions`",
        "operationId": "get-wallet-transactions",
        "parameters": [
          {
            "name": "state",
            "in": "query",
            "description": "Filter to retrieve transactions in a given state",
            "schema": {
              "type": "string",
              "format": "string",
              "default": "complete",
              "enum": [
                "complete",
                "pending",
                "failed",
                "reserved"
              ]
            }
          },
          {
            "name": "fromDate",
            "in": "query",
            "description": "Filter to retrieve transactions where `createdAt` >= `fromDate` (ISO8601: yyyy-MM-ddTHH:mm:ssZ)",
            "schema": {
              "type": "string",
              "format": "date-time"
            },
            "example": "2022-05-22T09:30:03Z"
          },
          {
            "name": "toDate",
            "in": "query",
            "description": "Filter to retrieve transactions where `createdAt` <= `toDate` (ISO8601: yyyy-MM-ddTHH:mm:ssZ)",
            "schema": {
              "type": "string",
              "format": "date-time"
            },
            "example": "2022-05-22T09:30:03Z"
          },
          {
            "name": "page",
            "in": "query",
            "description": "page number to retrieve (starts with 0)",
            "schema": {
              "type": "integer",
              "format": "int32",
              "default": 0
            },
            "example": 1
          },
          {
            "name": "perPage",
            "in": "query",
            "description": "number of items per page (between 1 and 100, default 10)",
            "schema": {
              "type": "integer",
              "format": "int32",
              "default": 10
            },
            "example": 10
          }
        ],
        "responses": {
          "200": {
            "description": "List of wallet transactions that match the criteria",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/MontaPage_TransactionDto_"
                }
              }
            }
          },
          "400": {
            "description": "User doesn't have access to resource",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "example": {
                    "status": "BAD_REQUEST",
                    "message": "Invalid request",
                    "errorCode": "BAD_REQUEST"
                  }
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized access",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "example": {
                    "status": "UNAUTHORIZED",
                    "message": "Invalid or expired `accessToken`.",
                    "errorCode": "INVALID_ACCESS_TOKEN"
                  }
                }
              }
            }
          },
          "404": {
            "description": "Team not found for user"
          }
        },
        "security": [
          {
            "BearerAccessToken": []
          }
        ]
      }
    }
  },
  "components": {
    "schemas": {
      "Currency": {
        "required": [
          "identifier",
          "name"
        ],
        "type": "object",
        "properties": {
          "identifier": {
            "type": "string",
            "description": "Currency identifier, e.g. DKK",
            "example": "DKK"
          },
          "name": {
            "type": "string",
            "description": "Readable name of currency",
            "example": "Danish krone"
          },
          "decimals": {
            "type": "integer",
            "description": "Number of decimals for this currency",
            "format": "int32",
            "example": 2
          }
        }
      },
      "MontaPage.Meta": {
        "required": [
          "currentPage",
          "itemCount",
          "perPage",
          "totalItemCount",
          "totalPageCount"
        ],
        "type": "object",
        "properties": {
          "itemCount": {
            "type": "integer",
            "format": "int32"
          },
          "currentPage": {
            "type": "integer",
            "format": "int32"
          },
          "perPage": {
            "type": "integer",
            "format": "int32"
          },
          "totalPageCount": {
            "type": "integer",
            "format": "int32"
          },
          "totalItemCount": {
            "type": "integer",
            "format": "int64"
          }
        }
      },
      "MontaPage_TransactionDto_": {
        "required": [
          "data",
          "meta"
        ],
        "type": "object",
        "properties": {
          "data": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/Transaction"
            }
          },
          "meta": {
            "$ref": "#/components/schemas/MontaPage.Meta"
          }
        }
      },
      "Transaction": {
        "required": [
          "createdAt",
          "exchangeRate",
          "fromAmount",
          "fromCurrency",
          "state",
          "toAmount",
          "toCurrency"
        ],
        "type": "object",
        "properties": {
          "id": {
            "type": "integer",
            "description": "Id of the transaction",
            "format": "int64",
            "example": 1
          },
          "state": {
            "type": "string",
            "description": "state of the transaction",
            "example": "complete",
            "enum": [
              "complete",
              "pending",
              "failed",
              "reserved"
            ]
          },
          "note": {
            "type": "string",
            "description": "note of the transaction",
            "nullable": true
          },
          "summary": {
            "type": "string",
            "description": "summary of the transaction",
            "nullable": true
          },
          "fromAmount": {
            "type": "number",
            "description": "Amount sent",
            "example": 13.77
          },
          "fromCurrency": {
            "description": "Currency for `fromAmount`.",
            "allOf": [
              {
                "$ref": "#/components/schemas/Currency"
              }
            ]
          },
          "fromWalletId": {
            "type": "integer",
            "description": "Id of the wallet where the amount was sent from. Can be `null` if the transaction did not originate from a wallet.",
            "format": "int64",
            "nullable": true,
            "example": 1
          },
          "toAmount": {
            "type": "number",
            "description": "Amount received",
            "example": 13.77
          },
          "toCurrency": {
            "description": "Currency used for `toAmount`.",
            "allOf": [
              {
                "$ref": "#/components/schemas/Currency"
              }
            ]
          },
          "toWalletId": {
            "type": "integer",
            "description": "Id of the wallet where the amount was sent to. Can be `null` if the transaction did not target a wallet.",
            "format": "int64",
            "nullable": true,
            "example": 2
          },
          "exchangeRate": {
            "type": "number",
            "description": "Exchange rate used for currency conversion",
            "example": 1
          },
          "createdAt": {
            "type": "string",
            "description": "Creation date of this transaction",
            "format": "date-time",
            "example": "2022-05-12T15:56:45.99Z"
          },
          "updatedAt": {
            "type": "string",
            "description": "Date this transaction was last updated",
            "format": "date-time",
            "nullable": true,
            "example": "2022-05-12T16:56:45.99Z"
          },
          "completedAt": {
            "type": "string",
            "description": "Date this transaction was last completed",
            "format": "date-time",
            "nullable": true,
            "example": "2022-05-12T16:56:45.99Z"
          }
        }
      }
    },
    "securitySchemes": {
      "BearerAccessToken": {
        "type": "http",
        "scheme": "bearer"
      }
    }
  }
}
```