> ## 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. # List transactions > Lists the transactions of the account, filtered by status, payment method, period and payer. Pagination is offset-based (`offset`). ## OpenAPI ````yaml /openapi.yaml get /transactions 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: /transactions: get: tags: - Transactions summary: List transactions description: >- Lists the transactions of the account, filtered by status, payment method, period and payer. Pagination is offset-based (`offset`). operationId: listTransactions parameters: - name: offset in: query required: false description: Number of transactions to skip. Starts at 0. schema: type: string default: '0' - name: status in: query required: false description: >- Filters by status. Repeat the parameter to combine values, or use `all` for every status. schema: type: string - name: transactionId in: query required: false description: Filters by transaction identifier. schema: type: string - name: paymentMethod in: query required: false description: Filters by payment method. schema: type: string enum: - pix - credit_card - boleto - name: initialDate in: query required: false description: Start of the period, as `YYYY-MM-DD` or `YYYY-MM-DDTHH:mm:ss`. schema: type: string - name: finalDate in: query required: false description: End of the period, as `YYYY-MM-DD` or `YYYY-MM-DDTHH:mm:ss`. schema: type: string - name: email in: query required: false description: Filters by the payer's email address. schema: type: string - name: phone in: query required: false description: Filters by the payer's phone number. schema: type: string - name: document in: query required: false description: Filters by the payer's CPF or CNPJ. schema: type: string - name: name in: query required: false description: Filters by the payer's name. schema: type: string responses: '200': description: Transactions of the account. content: application/json: schema: type: object properties: success: type: boolean data: type: array items: type: object properties: id: type: string description: Transaction identifier. paymentMethod: type: string description: Payment method. enum: - pix - credit_card - boleto amount: type: integer description: Gross amount of the transaction, in cents. netAmount: type: integer description: Net amount, after fees, in cents. fees: type: integer description: Fees charged, in cents. reservedAmount: type: integer nullable: true description: Portion of the amount held as reserve, in cents. reservedUntil: type: string format: date-time nullable: true description: When the reserve is released. externalId: type: string description: Transaction identifier at the acquirer. status: type: string description: Current status of the transaction. enum: - pending - waiting - paid - refused - canceled - expired - error - refund - chargeback - contest - infraction - preCharge description: type: string nullable: true description: Description provided at creation. createdAt: type: string description: Creation time. format: date-time updatedAt: type: string description: Time of the last change. format: date-time aprovedAt: type: string format: date-time nullable: true description: Time at which the payment was approved. refuseReason: type: string nullable: true description: Reason for the refusal, when applicable. acquirerCode: type: string nullable: true description: Acquirer return code. contestResolution: type: string nullable: true enum: - pending - won - lost - null description: Outcome of the dispute, when applicable. canSubmitContest: type: boolean description: '`true` while a defense can still be submitted.' customer: type: object nullable: true properties: id: type: string description: Customer identifier. name: type: string description: Payer's name. phone: type: string nullable: true documentType: type: string description: Document type. document: type: string description: Payer's CPF or CNPJ. emails: type: array nullable: true items: type: object properties: email: type: string TransactionItems: type: array nullable: true items: type: object properties: id: type: integer name: type: string description: type: string nullable: true quantity: type: integer unitPrice: type: integer description: Unit price, in cents. amount: type: integer description: Item total, in cents. tangible: type: boolean Pix: type: object nullable: true properties: key: type: string nullable: true endToEndId: type: string nullable: true description: >- Pix end-to-end identifier, available after settlement. payerInfo: nullable: true description: Payer data reported by the bank. totalRows: type: integer description: Total number of transactions matching the filter. example: success: true data: - id: cmddiqpxo09zf1yju2kqkhgga paymentMethod: pix amount: 4990 netAmount: 4840 fees: 150 reservedAmount: null reservedUntil: null externalId: 7fab0715-9a97-42ce-84e2-dc96dc347fb0 status: paid description: Invoice no. 2026/001042 createdAt: '2026-11-12T14:08:06.000Z' updatedAt: '2026-11-12T14:10:17.000Z' aprovedAt: '2026-11-12T14:10:17.000Z' refuseReason: null acquirerCode: null contestResolution: null canSubmitContest: false customer: id: cmddiq1a2000b1yju8xk2p9d1 name: Helena Martins Andrade phone: '11932104567' documentType: cpf document: '31845792041' emails: - email: helena.andrade@example.com TransactionItems: [] Pix: key: null endToEndId: E18236120202611121410s12e9976c00 payerInfo: null totalRows: 1 '401': description: Access token missing, invalid or expired. content: application/json: schema: type: object properties: success: type: boolean message: type: string required: - success - message example: success: false message: Não autorizado '403': description: Credential not linked to an account. content: application/json: schema: type: object properties: success: type: boolean message: type: string required: - success - message example: success: false message: Acesso negado security: - bearerAuth: [] components: securitySchemes: bearerAuth: type: http scheme: bearer bearerFormat: JWT ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.