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

# Retrieve account fees

> Returns the fees and settlement periods contracted for each payment method.



## OpenAPI

````yaml /openapi.yaml get /fees
openapi: 3.0.3
info:
  title: Fincle API
  version: 1.0.0
  description: >-
    Fincle payments API: charges by Pix, credit card and boleto, subscriptions,
    transactions, refunds, infractions, notifications and transfers.
servers:
  - url: https://api.fincle.com.br
    description: Production server
security: []
tags:
  - name: Authentication
    description: Issuance of the access token from the API key.
  - name: Charges
    description: Creation of charges by Pix, credit card and boleto.
  - name: Subscriptions
    description: Recurring billing on credit card.
  - name: Transactions
    description: Retrieval and refund of transactions.
  - name: Refunds
    description: Refund requests submitted by payers.
  - name: Infractions and MED
    description: Pix infraction reports and the amounts blocked as a result.
  - name: Webhooks
    description: Registration of notification endpoints and tracking of deliveries.
  - name: Balance and transfers
    description: Balance, statement, fees and transfer of the amounts received.
paths:
  /fees:
    get:
      tags:
        - Balance and transfers
      summary: Retrieve account fees
      description: >-
        Returns the fees and settlement periods contracted for each payment
        method.
      operationId: getFees
      responses:
        '200':
          description: Fees and settlement periods in force for the account.
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    type: boolean
                    description: Always `true` in a successful response.
                  data:
                    type: object
                    properties:
                      pix:
                        type: object
                        properties:
                          receiveDays:
                            type: integer
                            description: >-
                              Days between a Pix transaction and the credit to
                              the balance.
                          limit:
                            type: integer
                            nullable: true
                            description: >-
                              Per-transaction cap for Pix, in cents; `null` when
                              there is no cap.
                          feeFixed:
                            type: number
                            nullable: true
                            description: Fixed fee per Pix transaction, in cents.
                          feePercentage:
                            type: integer
                            nullable: true
                            description: >-
                              Percentage fee per Pix transaction, in hundredths
                              of a percent (299 = 2.99%).
                          reserve:
                            type: object
                            properties:
                              enabled:
                                type: boolean
                                description: >-
                                  `true` when part of each transaction is held
                                  as reserve.
                              days:
                                type: integer
                                description: Days the reserve is held before release.
                              percentage:
                                type: number
                                description: >-
                                  Percentage of each transaction allocated to
                                  the reserve, in percentage points.
                            required:
                              - enabled
                              - days
                              - percentage
                            additionalProperties: false
                        required:
                          - receiveDays
                          - limit
                          - feeFixed
                          - feePercentage
                          - reserve
                        additionalProperties: false
                      card:
                        type: object
                        properties:
                          receiveDays:
                            type: integer
                            description: >-
                              Days between a card transaction and the credit to
                              the balance.
                          limit:
                            type: integer
                            nullable: true
                            description: >-
                              Per-transaction cap for cards, in cents; `null`
                              when there is no cap.
                          feeFixed:
                            type: number
                            nullable: true
                            description: Fixed fee per card transaction, in cents.
                          feePercentage:
                            type: integer
                            nullable: true
                            description: >-
                              Percentage fee for single-payment card
                              transactions, in hundredths of a percent (499 =
                              4.99%).
                          reserve:
                            type: object
                            properties:
                              enabled:
                                type: boolean
                                description: >-
                                  `true` when part of each transaction is held
                                  as reserve.
                              days:
                                type: integer
                                description: Days the reserve is held before release.
                              percentage:
                                type: number
                                description: >-
                                  Percentage of each transaction allocated to
                                  the reserve, in percentage points.
                            required:
                              - enabled
                              - days
                              - percentage
                            additionalProperties: false
                          installmentFees:
                            type: array
                            items:
                              type: object
                              properties:
                                installmentNumber:
                                  type: integer
                                  description: >-
                                    Number of installments to which this fee
                                    applies.
                                fee:
                                  type: integer
                                  description: >-
                                    Percentage charged for that number of
                                    installments, in hundredths of a percent
                                    (1290 = 12.90%).
                                cardBrand:
                                  type: string
                                  enum:
                                    - AMERICAN_EXPRESS
                                    - DINERS_CLUB
                                    - DISCOVER
                                    - ELO
                                    - HIPERCARD
                                    - HIPER
                                    - JCB
                                    - MAESTRO
                                    - MASTERCARD
                                    - MIR
                                    - UNIONPAY
                                    - VISA
                                  nullable: true
                                  description: >-
                                    Card brand to which the row applies; `null`
                                    applies to all.
                              required:
                                - installmentNumber
                                - fee
                                - cardBrand
                              additionalProperties: false
                            description: Fee schedule by number of installments.
                        required:
                          - receiveDays
                          - limit
                          - feeFixed
                          - feePercentage
                          - reserve
                          - installmentFees
                        additionalProperties: false
                      boleto:
                        type: object
                        properties:
                          receiveDays:
                            type: integer
                            description: >-
                              Days between the clearing of a boleto and the
                              credit to the balance.
                          limit:
                            type: integer
                            nullable: true
                            description: >-
                              Cap per boleto, in cents; `null` when there is no
                              cap.
                          feeFixed:
                            type: number
                            nullable: true
                            description: Fixed fee per paid boleto, in cents.
                          feePercentage:
                            type: integer
                            nullable: true
                            description: >-
                              Percentage fee per paid boleto, in hundredths of a
                              percent (150 = 1.50%).
                        required:
                          - receiveDays
                          - limit
                          - feeFixed
                          - feePercentage
                        additionalProperties: false
                      withdrawal:
                        type: object
                        properties:
                          feeFixed:
                            type: number
                            nullable: true
                            description: Fixed fee per transfer, in cents.
                          feePercentage:
                            type: integer
                            nullable: true
                            description: >-
                              Percentage fee per transfer, in hundredths of a
                              percent (150 = 1.50%).
                        required:
                          - feeFixed
                          - feePercentage
                        additionalProperties: false
                      highTicket:
                        type: object
                        properties:
                          thresholdCents:
                            type: integer
                            description: >-
                              Transaction amount, in cents, from which the tier
                              applies.
                          cardFeeFixed:
                            type: number
                            nullable: true
                            description: Fixed card fee in the tier, in cents.
                          cardFeePercentage:
                            type: integer
                            nullable: true
                            description: >-
                              Percentage card fee in the tier, in hundredths of
                              a percent.
                          pixFeeFixed:
                            type: number
                            nullable: true
                            description: Fixed Pix fee in the tier, in cents.
                          pixFeePercentage:
                            type: integer
                            nullable: true
                            description: >-
                              Percentage Pix fee in the tier, in hundredths of a
                              percent.
                          installmentFees:
                            type: array
                            items:
                              type: object
                              properties:
                                installmentNumber:
                                  type: integer
                                  description: >-
                                    Number of installments to which this fee
                                    applies.
                                fee:
                                  type: integer
                                  description: >-
                                    Installment percentage within the tier, in
                                    hundredths of a percent (1290 = 12.90%).
                              required:
                                - installmentNumber
                                - fee
                              additionalProperties: false
                        required:
                          - thresholdCents
                          - cardFeeFixed
                          - cardFeePercentage
                          - pixFeeFixed
                          - pixFeePercentage
                          - installmentFees
                        additionalProperties: false
                        nullable: true
                        description: >-
                          High-value tier, when active on the account; `null`
                          otherwise.
                    required:
                      - pix
                      - card
                      - boleto
                      - withdrawal
                      - highTicket
                    additionalProperties: false
                required:
                  - success
                  - data
                additionalProperties: false
                description: Fees and settlement periods in force for the account.
              example:
                success: true
                data:
                  pix:
                    receiveDays: 1
                    limit: null
                    feeFixed: 99
                    feePercentage: 299
                    reserve:
                      enabled: true
                      days: 30
                      percentage: 5
                  card:
                    receiveDays: 15
                    limit: 500000
                    feeFixed: 99
                    feePercentage: 499
                    reserve:
                      enabled: true
                      days: 30
                      percentage: 5
                    installmentFees:
                      - installmentNumber: 1
                        fee: 499
                        cardBrand: null
                      - installmentNumber: 12
                        fee: 1290
                        cardBrand: null
                  boleto:
                    receiveDays: 2
                    limit: null
                    feeFixed: 299
                    feePercentage: 150
                  withdrawal:
                    feeFixed: 350
                    feePercentage: 0
                  highTicket: null
        '401':
          description: Token missing, invalid, expired or belonging to a blocked account.
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    type: boolean
                    description: Always `false` in an error response.
                  message:
                    type: string
                    description: Readable message explaining the failure.
                required:
                  - success
                  - message
                additionalProperties: false
                description: >-
                  Token missing, invalid, expired or belonging to a blocked
                  account.
              example:
                success: false
                message: Token inválido ou expirado
        '422':
          description: The request did not pass schema validation.
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    type: boolean
                    description: Always `false` in an error response.
                  message:
                    type: string
                    description: Readable message explaining the failure.
                required:
                  - success
                  - message
                additionalProperties: false
                description: The request did not pass schema validation.
              example:
                success: false
                message: 'name: Nome é obrigatório'
        '429':
          description: >-
            Too many requests: the limit is 1000 requests per minute per source
            IP. Wait the number of seconds given in the `retry-after` header and
            retry with exponential backoff.
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    type: boolean
                    description: Always `false` in an error response.
                  message:
                    type: string
                    description: Readable message explaining the failure.
                required:
                  - success
                  - message
                additionalProperties: false
                description: >-
                  Too many requests: the limit is 1000 requests per minute per
                  source IP. Wait the number of seconds given in the
                  `retry-after` header and retry with exponential backoff.
              example:
                success: false
                message: Muitas requisições. Tente novamente em breve.
          headers:
            retry-after:
              $ref: '#/components/headers/retry-after'
            x-ratelimit-limit:
              $ref: '#/components/headers/x-ratelimit-limit'
            x-ratelimit-remaining:
              $ref: '#/components/headers/x-ratelimit-remaining'
            x-ratelimit-reset:
              $ref: '#/components/headers/x-ratelimit-reset'
        '500':
          description: >-
            Internal failure while processing the request. Retry; if it
            persists, open a support ticket stating the time and the route.
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    type: boolean
                    description: Always `false` in an error response.
                  message:
                    type: string
                    description: Readable message explaining the failure.
                required:
                  - success
                  - message
                additionalProperties: false
                description: >-
                  Internal failure while processing the request. Retry; if it
                  persists, open a support ticket stating the time and the
                  route.
              example:
                success: false
                message: Erro interno do servidor
      security:
        - bearerAuth: []
components:
  headers:
    retry-after:
      description: Seconds to wait before repeating the request.
      schema:
        type: integer
    x-ratelimit-limit:
      description: >-
        Maximum number of requests in the window (1000). Present in every
        response.
      schema:
        type: integer
    x-ratelimit-remaining:
      description: >-
        Number of requests still available in the current window. Present in
        every response.
      schema:
        type: integer
    x-ratelimit-reset:
      description: Seconds until the window counter resets. Present in every response.
      schema:
        type: integer
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.