Retrieve statement

Lists the financial transactions recorded in the Asaas account statement, paginated.

Use this operation for historical queries, reconciliation and auditing of the transactions that affected the balance. Each item represents a financial entry, and a single operation may generate more than one related entry, such as receiving a payment and the corresponding fee.

The statement shows the financial transaction, but does not replace the complete data of the resource that originated it. When available, identifiers such as paymentId, transferId, anticipationId, billId and others let you link the entry to the corresponding resource.

Interpreting type

The type field identifies the nature of the transaction returned in the statement.

Some types used internally are normalized before the API response:

  • Pix transfer debits are returned as TRANSFER;
  • fees for these Pix debits are returned as TRANSFER_FEE;
  • anticipation partner settlements are returned as RECEIVABLE_ANTICIPATION_DEBIT.

Therefore, PIX_TRANSACTION_DEBIT, PIX_TRANSACTION_DEBIT_FEE and RECEIVABLE_ANTICIPATION_PARTNER_SETTLEMENT are not returned as a type value by this endpoint.

🚧

Compatibility with new types

New type values may be added as new products and financial transactions become available.

Avoid implementing validations that stop processing when a type not yet known to your integration is received.

Available types

  • ASAAS_CARD_RECHARGE - Asaas card recharge
  • ASAAS_CARD_RECHARGE_REVERSAL - Card recharge reversal
  • ASAAS_CARD_TRANSACTION - Transaction made with the Asaas card
  • ASAAS_CARD_CASHBACK - Cashback received with the Asaas card
  • ASAAS_CARD_TRANSACTION_FEE - Fee for a transaction made with the Asaas card
  • ASAAS_CARD_TRANSACTION_FEE_REFUND - Refund of the fee for a transaction made with the Asaas card
  • ASAAS_CARD_TRANSACTION_PARTIAL_REFUND - Partial refund of a transaction made with the Asaas card
  • ASAAS_CARD_TRANSACTION_PARTIAL_REFUND_CANCELLATION - Cancellation of the partial refund of a transaction made with the Asaas card
  • ASAAS_CARD_TRANSACTION_REFUND - Refund of a transaction made with the Asaas card
  • ASAAS_CARD_TRANSACTION_REFUND_CANCELLATION - Cancellation of the refund of a transaction made with the Asaas card
  • ASAAS_MONEY_PAYMENT_ANTICIPATION_FEE_REFUND - Refund of the Asaas Money installment fee
  • ASAAS_MONEY_PAYMENT_COMPROMISED_BALANCE_REFUND - Cancellation of the balance hold committed to an Asaas Money payment
  • ASAAS_MONEY_PAYMENT_FINANCING_FEE_REFUND - Refund of the Asaas Money financing fee
  • ASAAS_MONEY_TRANSACTION_CASHBACK_REFUND - Asaas Money cashback reversal
  • ASAAS_MONEY_TRANSACTION_CHARGEBACK - Asaas Money transaction chargeback
  • ASAAS_MONEY_TRANSACTION_CHARGEBACK_REVERSAL - Asaas Money transaction chargeback reversal
  • BILL_PAYMENT - Bill payment
  • BILL_PAYMENT_CANCELLED - Bill payment cancellation
  • BILL_PAYMENT_REFUNDED - Bill payment refund
  • BILL_PAYMENT_FEE - Bill payment fee
  • BILL_PAYMENT_FEE_CANCELLED - Bill payment fee cancellation
  • CHARGEBACK - Balance hold due to a payment chargeback
  • CHARGEBACK_REVERSAL - Cancellation of the balance hold due to chargeback
  • CHARGED_FEE_REFUND - Refund of the payment dunning or Pix fee
  • CONTRACTUAL_EFFECT_SETTLEMENT - Reserved receivables amount
  • CONTRACTUAL_EFFECT_SETTLEMENT_REVERSAL - Reversal of the reserved receivables amount
  • CREDIT - Credit
  • CREDIT_BUREAU_REPORT - Credit Bureau Report (Serasa) fee
  • CUSTOMER_COMMISSION_SETTLEMENT_CREDIT - Partner commission settlement credit
  • CUSTOMER_COMMISSION_SETTLEMENT_DEBIT - Partner commission settlement debit
  • DEBIT - Debit
  • DEBIT_REVERSAL - Debit reversal
  • DEBT_RECOVERY_NEGOTIATION_FINANCIAL_CHARGES - Renegotiation charges
  • FREE_PAYMENT_USE - Fee refund from a promotional campaign
  • INTERNAL_TRANSFER_CREDIT - Transfer from the Asaas account
  • INTERNAL_TRANSFER_DEBIT - Transfer to the Asaas account
  • INTERNAL_TRANSFER_REVERSAL - Reversal of a transfer to the Asaas account
  • INVOICE_FEE - Service invoice issuance fee
  • PAYMENT_DUNNING_CANCELLATION_FEE - Payment dunning cancellation fee
  • PAYMENT_DUNNING_RECEIVED_FEE - Payment dunning fee
  • PAYMENT_DUNNING_RECEIVED_IN_CASH_FEE - Fee for payment dunning received in cash
  • PAYMENT_DUNNING_REQUEST_FEE - Payment dunning fee
  • PAYMENT_FEE - Bank slip, card or Pix fee
  • PAYMENT_FEE_REVERSAL - Reversal of the bank slip, card or Pix fee
  • PAYMENT_MESSAGING_NOTIFICATION_FEE - Invoice messaging fee
  • PAYMENT_RECEIVED - Payment received
  • PAYMENT_CUSTODY_BLOCK - Balance hold for custody
  • PAYMENT_CUSTODY_BLOCK_REVERSAL - Balance release from custody
  • PAYMENT_REFUND_CANCELLED - Cancellation of the invoice refund
  • PAYMENT_REVERSAL - Invoice refund
  • PAYMENT_SMS_NOTIFICATION_FEE - Payment SMS notification fee
  • PHONE_CALL_NOTIFICATION_FEE - Voice notification fee
  • PIX_TRANSACTION_CREDIT - Pix transfer received
  • PIX_TRANSACTION_CREDIT_FEE - Fee for Pix transfer received
  • PIX_TRANSACTION_CREDIT_REFUND - Refund of a Pix receipt
  • PIX_TRANSACTION_CREDIT_REFUND_CANCELLATION - Cancellation of the refund of a Pix receipt
  • PIX_TRANSACTION_DEBIT_REFUND - Refund of a Pix transaction
  • POSTAL_SERVICE_FEE - Fee for sending bank slips by mail (Correios)
  • PRODUCT_INVOICE_FEE - Issuance fee for product invoices issued via Base ERP
  • CONSUMER_INVOICE_FEE - Issuance fee for consumer invoices issued via Base ERP
  • PROMOTIONAL_CODE_CREDIT - Fee discount
  • PROMOTIONAL_CODE_DEBIT - Reversal of the fee discount
  • RECEIVABLE_ANTICIPATION_GROSS_CREDIT - Anticipation of an installment or payment
  • RECEIVABLE_ANTICIPATION_DEBIT - Settlement of the installment or anticipation
  • RECEIVABLE_ANTICIPATION_FEE - Fee for anticipation of an installment or payment
  • REFUND_REQUEST_CANCELLED - Cancellation of the invoice refund
  • REFUND_REQUEST_FEE - Invoice refund fee
  • REFUND_REQUEST_FEE_REVERSAL - Cancellation of the invoice refund fee
  • REVERSAL - Reversal
  • TRANSFER - Transfer to a bank account, including Pix debits normalized in the response
  • TRANSFER_FEE - Transfer fee, including Pix debit fees normalized in the response
  • MOBILE_PHONE_RECHARGE - Mobile phone recharge
  • REFUND_MOBILE_PHONE_RECHARGE - Mobile phone recharge refund
  • CANCEL_MOBILE_PHONE_RECHARGE - Mobile phone recharge cancellation
  • INSTANT_TEXT_MESSAGE_FEE - WhatsApp notification fee
  • ASAAS_CARD_BALANCE_REFUND - Asaas card refund
  • BACEN_JUDICIAL_LOCK - Judicial hold
  • BACEN_JUDICIAL_UNLOCK - Judicial release
  • BACEN_JUDICIAL_TRANSFER - Judicial transfer
  • ASAAS_DEBIT_CARD_REQUEST_FEE - Elo debit card enrollment fee
  • ASAAS_PREPAID_CARD_REQUEST_FEE - Elo prepaid card enrollment fee
  • EXTERNAL_SETTLEMENT_CONTRACTUAL_EFFECT_BATCH_CREDIT - Credit of amounts for settlement of contractual effects
  • EXTERNAL_SETTLEMENT_CONTRACTUAL_EFFECT_BATCH_REVERSAL - Reversal of amounts related to the settlement of contractual effects
  • ASAAS_CARD_BILL_PAYMENT - Asaas card bill payment
  • CHILD_ACCOUNT_KNOWN_YOUR_CUSTOMER_BATCH_FEE - Child account creation fee
  • CONTRACTED_CUSTOMER_PLAN_FEE - Asaas plan monthly fee
  • ACCOUNT_INACTIVITY_FEE - Inactive account fee

Legacy types

The types below are no longer generated for new transactions, but may appear when querying historical records:

  • ASAAS_MONEY_PAYMENT_ANTICIPATION_FEE
  • ASAAS_MONEY_PAYMENT_COMPROMISED_BALANCE
  • ASAAS_MONEY_PAYMENT_FINANCING_FEE
  • ASAAS_MONEY_TRANSACTION_CASHBACK
  • PARTIAL_PAYMENT

Related content

Guides

Error Library

Query Params
integer

List starting element

integer
≤ 100

Number of list elements (max: 100)

string

List start date

string

List end date

string

Result ordering

Responses

403

Forbidden. Occurs when the request body is filled, GET method calls must have an empty body.

Language
Credentials
Header
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json