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

# List fees

> Returns fee records assessed against merchants, including per-transaction and recurring fees. Supports the standard query envelope.



## OpenAPI

````yaml /openapi.json post /v1/query/fees
openapi: 3.0.0
info:
  title: Jupico - OpenAPI 3.0
  description: >-
    The Jupico API lets Service Providers onboard merchants, process card and
    eCheck (ACH) payments, run hosted payment pages, manage recurring billing,
    send payouts, and query every resource. All endpoints use HTTPS with Basic
    authentication and accept and return JSON. Endpoints are grouped by
    workflow: onboard merchants first, then accept payments, then move funds and
    report.
  termsOfService: https://help.jupico.com/references-and-resources/legal
  contact:
    email: support@jupico.com
  license:
    name: Jupico License
    url: https://jupico.com
  version: 1.0.5
servers:
  - url: https://sandbox-platform.jupico.com
security:
  - basicAuth: []
tags:
  - name: Status
    description: Health check for the Jupico API.
  - name: Onboarding Invites
    description: >-
      Create and send invites that onboard merchants through the Jupico-hosted
      flow, with optional pre-filled identity, fees, and payout bank account
      data.
  - name: Provisioning
    description: >-
      Onboard merchants from your own UI. Collect onboarding data and submit it
      through the provisioning chain: applicant → application → submerchant.
  - name: Session
    description: >-
      Create browser authorization sessions for the Jupico web components, so
      card and bank account data is tokenized client-side and never touches your
      servers.
  - name: Tokenization
    description: >-
      Convert one-time tokens from the web components into permanent Jupico
      tokens, or tokenize raw card data if your systems are PCI DSS compliant.
  - name: Customer
    description: >-
      Create and manage customer records that payments, subscriptions,
      installments, and invoices link to.
  - name: Card Transactions
    description: >-
      Process credit and debit card transactions using tokenized card data:
      sale, authorization, capture, void, refund, and rollback.
  - name: eCheck Transactions
    description: >-
      Debit customer bank accounts via eCheck (ACH): sale, void, refund,
      rollback, and bank account tokenization.
  - name: Checkouts
    description: >-
      Hosted checkout sessions where customers complete payment on a
      Jupico-hosted page.
  - name: Payment Links
    description: >-
      Shareable links that open a Jupico-hosted payment page — no integration
      code needed at the point of sharing.
  - name: Invoices
    description: Create and email invoices that customers pay online.
  - name: Subscriptions
    description: >-
      Recurring billing. Plans define billing schedules and pricing models;
      subscriptions enroll customers against a stored payment token.
  - name: Installments
    description: Split a fixed total into scheduled payments with an optional deposit.
  - name: Payouts
    description: >-
      Send funds from a submerchant's available balance to a tokenized bank
      account with on-demand payout instructions.
  - name: Query
    description: >-
      Search and report across every resource: transactions, merchants,
      settlements, balances, disputes, fees, and more. All query endpoints
      accept the same filter, sort, and pagination envelope — see the Query
      Capabilities guide.
paths:
  /v1/query/fees:
    post:
      tags:
        - Query
      summary: List fees
      description: >-
        Returns fee records assessed against merchants, including
        per-transaction and recurring fees. Supports the standard query
        envelope.
      operationId: findAllFees
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
      responses:
        '200':
          $ref: '#/components/responses/findAllFees'
      security:
        - basicAuth: []
components:
  responses:
    findAllFees:
      description: findAllTransactions
      content:
        application/json:
          schema:
            type: object
            properties:
              success:
                type: boolean
                description: >-
                  Whether the request was processed successfully. Declines
                  return HTTP 200 with `success: false`.
              message:
                type: string
                description: Human-readable result message.
              code:
                type: string
                description: Machine-readable result code. See the Error Codes reference.
              data:
                type: array
                items:
                  type: object
                  properties:
                    _id:
                      type: string
                      description: Internal document identifier.
                    review:
                      type: object
                      properties:
                        enabled:
                          type: boolean
                          description: Whether this setting is enabled.
                        logs:
                          type: array
                          items:
                            type: string
                          description: Event log entries.
                      description: Risk review details for the transaction.
                    platformFee:
                      type: number
                      description: Portion of the fee billed at the platform level.
                    spProductFee:
                      type: number
                      description: >-
                        Portion of the fee billed at the Service Provider
                        product level.
                    batchPayoutId:
                      type: string
                      description: >-
                        Identifier of the payout batch this instruction was
                        grouped into.
                    status:
                      type: string
                      description: Current status.
                    transaction:
                      type: object
                      properties:
                        transactionId:
                          type: string
                          description: Unique identifier of the original transaction.
                        dynamicFee:
                          type: boolean
                          description: >-
                            Fee added to the transaction at processing time and
                            itemized separately.
                        platformFixedFee:
                          type: number
                          description: Fixed fee applied at the platform level.
                        platformDiscountRate:
                          type: number
                          description: Percentage rate applied at the platform level.
                        platformReturnRate:
                          type: number
                          description: Return rate applied at the platform level.
                        platformReverseFixed:
                          type: number
                          description: Reversed fixed fee at the platform level.
                        platformReverseDiscountRate:
                          type: number
                          description: Reversed percentage fee at the platform level.
                        platformParentFixedFee:
                          type: number
                          description: >-
                            Fixed fee inherited from the parent transaction at
                            the platform level.
                        spProductParentFixedFee:
                          type: number
                          description: >-
                            Fixed fee inherited from the parent transaction at
                            the Service Provider product level.
                        spProductFixedFee:
                          type: number
                          description: >-
                            Fixed fee applied at the Service Provider product
                            level.
                        spProductDiscountRate:
                          type: number
                          description: >-
                            Percentage rate applied at the Service Provider
                            product level.
                        spProductReturnRate:
                          type: number
                          description: >-
                            Return rate applied at the Service Provider product
                            level.
                        spProductReverseFixed:
                          type: number
                          description: >-
                            Reversed fixed fee at the Service Provider product
                            level.
                        spProductReverseDiscountRate:
                          type: number
                          description: >-
                            Reversed percentage fee at the Service Provider
                            product level.
                        txAmount:
                          type: number
                          description: Amount of the underlying transaction.
                        txBalanceAmount:
                          type: number
                          description: Remaining balance of the underlying transaction.
                        referenceNumber:
                          type: string
                          description: Processor reference number for the transaction.
                        txOperation:
                          type: string
                          description: Operation type of the underlying transaction.
                      description: Details of the underlying transaction.
                    txDate:
                      type: string
                      description: Date and time of the transaction (ISO 8601).
                    fee:
                      type: number
                      description: Total fee amount.
                    type:
                      type: string
                      description: The type.
                    subMerchantId:
                      type: string
                      description: Unique identifier of the submerchant.
                    spProductId:
                      type: string
                      description: >-
                        Identifier of the Service Provider product the merchant
                        belongs to.
                    createdAt:
                      type: string
                      description: Timestamp when the object was created (ISO 8601).
                    updatedAt:
                      type: string
                      description: Timestamp when the object was last updated (ISO 8601).
                description: The response payload.
              count:
                type: number
                description: Number of records.
              query:
                type: object
                properties:
                  criteria:
                    type: object
                    properties:
                      isDeleted:
                        type: object
                        properties:
                          $in:
                            type: array
                            items:
                              type: boolean
                            description: Matches any value in the list.
                        description: Whether the record is soft-deleted.
                    description: Filter criteria applied, keyed by field path.
                  options:
                    type: object
                    properties:
                      fields:
                        type: object
                        properties:
                          _id:
                            type: number
                            description: >-
                              Set to 1 to include this field in results, or 0 to
                              exclude it.
                          transaction:
                            type: number
                            description: >-
                              Set to 1 to include this field in results, or 0 to
                              exclude it.
                          schedule:
                            type: number
                            description: >-
                              Set to 1 to include this field in results, or 0 to
                              exclude it.
                          chargeback:
                            type: number
                            description: >-
                              Set to 1 to include this field in results, or 0 to
                              exclude it.
                          platformFee:
                            type: number
                            description: >-
                              Set to 1 to include this field in results, or 0 to
                              exclude it.
                          spProductFee:
                            type: number
                            description: >-
                              Set to 1 to include this field in results, or 0 to
                              exclude it.
                          batchPayoutId:
                            type: number
                            description: >-
                              Set to 1 to include this field in results, or 0 to
                              exclude it.
                          status:
                            type: number
                            description: >-
                              Set to 1 to include this field in results, or 0 to
                              exclude it.
                          txDate:
                            type: number
                            description: >-
                              Set to 1 to include this field in results, or 0 to
                              exclude it.
                          fee:
                            type: number
                            description: >-
                              Set to 1 to include this field in results, or 0 to
                              exclude it.
                          type:
                            type: number
                            description: >-
                              Set to 1 to include this field in results, or 0 to
                              exclude it.
                          subMerchantId:
                            type: number
                            description: >-
                              Set to 1 to include this field in results, or 0 to
                              exclude it.
                          spProductId:
                            type: number
                            description: >-
                              Set to 1 to include this field in results, or 0 to
                              exclude it.
                          createdAt:
                            type: number
                            description: >-
                              Set to 1 to include this field in results, or 0 to
                              exclude it.
                          updatedAt:
                            type: number
                            description: >-
                              Set to 1 to include this field in results, or 0 to
                              exclude it.
                          review:
                            type: number
                            description: >-
                              Set to 1 to include this field in results, or 0 to
                              exclude it.
                        description: >-
                          Field projection: keys map to 1 (include) or 0
                          (exclude).
                    description: 'Query options: pagination, sorting, and field projection.'
                description: Echo of the query envelope that produced this result.
  securitySchemes:
    basicAuth:
      type: http
      scheme: basic

````