> ## Documentation Index
> Fetch the complete documentation index at: https://dev.moonpay.com/llms.txt
> Use this file to discover all available pages before exploring further.

# List transactions

> List transactions for the connected user with optional date filtering and pagination



## OpenAPI

````yaml GET /platform/v1/transactions
openapi: 3.1.0
info:
  title: MoonPay
  version: 1.0.0
servers:
  - url: https://api.moonpay.com
    description: Production Environment
    variables: {}
  - url: https://api.moonpay.dev
    description: Sandbox Environment
    variables: {}
security: []
tags:
  - name: Assets
  - name: Quote
  - name: Customer
  - name: Identity
  - name: Transactions
paths:
  /platform/v1/transactions:
    get:
      tags:
        - Transactions
      summary: List transactions
      description: >-
        Returns a paginated list of transactions for the connected customer. Use
        `startDate` and `endDate` to filter by creation time.
      operationId: TransactionController.findAll
      parameters:
        - $ref: '#/components/parameters/TransactionPaginationQueryParams.startDate'
        - $ref: '#/components/parameters/TransactionPaginationQueryParams.endDate'
        - $ref: '#/components/parameters/MoonPay.Core.PaginationQueryParams.cursor'
        - $ref: '#/components/parameters/MoonPay.Core.PaginationQueryParams.limit'
      responses:
        '200':
          description: The request has succeeded.
          headers:
            X-Request-Id:
              required: true
              schema:
                type: string
          content:
            application/json:
              schema:
                type: object
                required:
                  - data
                  - pageInfo
                properties:
                  data:
                    type: array
                    items:
                      $ref: '#/components/schemas/Transaction'
                  pageInfo:
                    $ref: '#/components/schemas/MoonPay.Core.PaginationInfo'
                unevaluatedProperties:
                  not: {}
      security:
        - AccessTokenAuth: []
components:
  parameters:
    TransactionPaginationQueryParams.startDate:
      name: startDate
      in: query
      required: false
      description: >-
        Filter transactions created on or after this date. [ISO
        8601](https://en.wikipedia.org/wiki/ISO_8601) format.
      schema:
        type: string
        format: date-time
      explode: false
    TransactionPaginationQueryParams.endDate:
      name: endDate
      in: query
      required: false
      description: >-
        Filter transactions created on or before this date. [ISO
        8601](https://en.wikipedia.org/wiki/ISO_8601) format.
      schema:
        type: string
        format: date-time
      explode: false
    MoonPay.Core.PaginationQueryParams.cursor:
      name: cursor
      in: query
      required: false
      description: >-
        Cursor for pagination. Use the `nextCursor` value from the previous
        response.
      schema:
        type: string
      explode: false
    MoonPay.Core.PaginationQueryParams.limit:
      name: limit
      in: query
      required: false
      description: Number of items to return per page.
      schema:
        type: integer
        format: int32
        minimum: 1
        maximum: 50
        default: 50
      explode: false
  schemas:
    Transaction:
      type: object
      required:
        - id
        - createdAt
        - updatedAt
        - status
        - source
        - destination
        - fees
        - wallet
        - customer
      properties:
        id:
          type: string
          description: The MoonPay ID of the transaction.
          examples:
            - fd43b900-593b-4125-9616-7d721ecbe875
        createdAt:
          type: string
          format: date-time
          description: >-
            An [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) timestamp of
            when the transaction was created.
          examples:
            - '2026-01-29T14:30:50.000Z'
        updatedAt:
          type: string
          format: date-time
          description: >-
            An [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) timestamp of
            when the transaction was last updated.
          examples:
            - '2026-01-29T15:30:50.000Z'
        status:
          $ref: '#/components/schemas/TransactionStatus'
        source:
          type: object
          required:
            - amount
            - asset
          properties:
            amount:
              type: string
              description: A stringified amount, which can include decimals.
              examples:
                - '100.02'
                - '10.22'
                - '1.00'
                - '10'
                - '1'
            asset:
              allOf:
                - $ref: '#/components/schemas/AssetBase'
              description: The currency or token being spent
              examples:
                - code: USD
          unevaluatedProperties:
            not: {}
          description: Source amount and asset (fiat currency) the customer paid.
          examples:
            - amount: '100.02'
              asset:
                code: USD
        destination:
          type: object
          required:
            - amount
            - asset
          properties:
            amount:
              type: string
              description: A stringified amount, which can include decimals.
              examples:
                - '100.02'
                - '10.22'
                - '1.00'
                - '10'
                - '1'
            asset:
              $ref: '#/components/schemas/AssetBase'
          unevaluatedProperties:
            not: {}
          description: Destination amount and asset (cryptocurrency) the customer receives.
          examples:
            - amount: '100.02'
              asset:
                code: USDC
        fees:
          allOf:
            - $ref: '#/components/schemas/Fees'
          description: Details of fees for the transaction.
        wallet:
          allOf:
            - $ref: '#/components/schemas/Wallet'
          description: The wallet used for the transaction.
        customer:
          $ref: '#/components/schemas/TransactionCustomer'
        paymentMethod:
          $ref: '#/components/schemas/TransactionPaymentMethod'
    MoonPay.Core.PaginationInfo:
      type: object
      required:
        - nextCursor
      properties:
        nextCursor:
          anyOf:
            - type: string
            - type: 'null'
          description: >-
            The cursor to use as the starting point for the next page of
            results.
          default: null
      unevaluatedProperties:
        not: {}
    TransactionStatus:
      type: string
      enum:
        - completed
        - failed
        - pending
      description: >-
        The status of a transaction.


        - `completed`: The transaction is finalized and assets were delivered.

        - `failed`: The transaction failed. No payment was executed and funds
        were not transferred.

        - `pending`: The transaction was created and payment is accepted. The
        transfer is in progress.
    AssetBase:
      type: object
      required:
        - code
      properties:
        code:
          type: string
          description: >-
            A fiat or crypto currency code.


            **Fiat**

            Fiat codes are represented as [ISO
            4217](https://en.wikipedia.org/wiki/ISO_4217) codes.


            Currently only `USD` is supported.


            **Crypto**

            For crypto currency codes, see [supported
            currencies](https://dev.moonpay.com/docs/list-of-supported-cryptocurrencies).


            Examples: `BTC` `SOL` `ETH` `USDC_BASE` `USDC_SOL`
      unevaluatedProperties:
        not: {}
    Fees:
      type: object
      properties:
        network:
          allOf:
            - $ref: '#/components/schemas/MonetaryFeeAmount'
          description: Network fees (in fiat) for the transaction.
        moonpay:
          allOf:
            - $ref: '#/components/schemas/MonetaryFeeAmount'
          description: MoonPay fees (in fiat) for the transaction.
        ecosystem:
          allOf:
            - $ref: '#/components/schemas/MonetaryFeeAmount'
          description: Ecosystem fees (in fiat) for the transaction, if applicable.
        defi:
          allOf:
            - $ref: '#/components/schemas/MonetaryFeeAmount'
          description: >-
            DeFi swap fee (in fiat) for the transaction, converted to the
            quote's base currency like the other fees. Present only for DeFi
            swaps that carry an itemized swap fee; when the fee is taken
            on-chain it is reflected in `destination.amount` instead.
        partner:
          allOf:
            - $ref: '#/components/schemas/MonetaryFeeAmount'
          description: >-
            Partner fees (in fiat) for the transaction, if applicable.
            Deprecated: use `fees.ecosystem` instead. This field will be removed
            in a future release.
          deprecated: true
      unevaluatedProperties:
        not: {}
      examples:
        - network:
            amount: '2.39'
            asset:
              code: USD
          moonpay:
            amount: '4.99'
            asset:
              code: USD
          ecosystem:
            amount: '1.00'
            asset:
              code: USD
    Wallet:
      type: object
      required:
        - address
      properties:
        address:
          type: string
          description: The wallet address used for the transaction.
          examples:
            - '0x1234567890123456789012345678901234567890'
        tag:
          type: string
          description: >-
            An optional memo or destination tag (used by some blockchains such
            as XRP or XLM).
      unevaluatedProperties:
        not: {}
      examples:
        - address: '0x1234567890123456789012345678901234567890'
    TransactionCustomer:
      type: object
      required:
        - id
      properties:
        id:
          type: string
          description: The MoonPay ID of the customer associated with the transaction.
          examples:
            - e0dee0ac-4e62-4866-b044-f66c0e4046e9
      unevaluatedProperties:
        not: {}
    TransactionPaymentMethod:
      type: object
      required:
        - type
      properties:
        type:
          $ref: '#/components/schemas/PaymentMethodType'
      unevaluatedProperties:
        not: {}
    MonetaryFeeAmount:
      type: object
      required:
        - amount
        - asset
      properties:
        amount:
          type: string
          description: The amount of fees in fiat.
          examples:
            - '1'
            - '1.00'
            - '10.22'
            - '100.02'
        asset:
          allOf:
            - $ref: '#/components/schemas/AssetBase'
          description: The fiat currency used to pay the fees.
          examples:
            - code: USD
      unevaluatedProperties:
        not: {}
    PaymentMethodType:
      type: string
      enum:
        - apple_pay
        - card
        - ach
        - fps
        - fps_open_banking
        - google_pay
        - sepa
        - sepa_open_banking
        - pix
        - paypal
        - venmo
        - revolut_pay
        - moonpay_balance
        - interac
  securitySchemes:
    AccessTokenAuth:
      type: http
      scheme: bearer
      description: |-
        Bearer authentication header using an access token.

        Example: `Authorization: Bearer <accessToken>`

````