> ## Documentation Index > Fetch the complete documentation index at: https://docs.kiwify.com.br/llms.txt > Use this file to discover all available pages before exploring further. # Listar Extrato > Obtém o extrato da conta. São as mesmas transações que aparecem no seu app web ou mobile. ## OpenAPI ````yaml /api-reference/banking/openapi.pt.json get /v1/transactions openapi: 3.1.0 info: title: API Conta Digital description: API pública para gerenciamento de conta, extrato e operações PIX license: name: '' version: 0.1.0 servers: - url: https://conta-public-api.kiwify.com description: Production environment security: [] tags: - name: Conta description: Detalhes da conta, saldo, limites e chaves PIX - name: Extrato description: Extrato e histórico de transações - name: Enviar Pix description: Enviar dinheiro via transferências PIX - name: Receber Pix description: Reembolsar transações PIX - name: Pagar boletos description: Pagar boletos via API - name: QR Codes PIX description: Geração de QR codes PIX para receber pagamentos - name: Webhooks description: >- Gerenciamento de assinaturas de webhook para recebimento de notificações de eventos paths: /v1/transactions: get: tags: - Extrato summary: Listar Extrato description: >- Obtém o extrato da conta. São as mesmas transações que aparecem no seu app web ou mobile. operationId: get_transactions parameters: - name: cursor in: query description: >- Pagination cursor (`":"`). Opaque token from a previous response's pagination metadata. required: false schema: type: - string - 'null' - name: before in: query description: >- Return transactions created before this instant (UTC, RFC 3339). Exclusive upper bound. required: false schema: type: - string - 'null' format: date-time - name: after in: query description: >- Return transactions created after this instant (UTC, RFC 3339). Exclusive lower bound. required: false schema: type: - string - 'null' format: date-time - name: limit in: query required: false schema: type: - integer - 'null' format: int32 minimum: 0 - name: search_term in: query required: false schema: type: - string - 'null' responses: '200': description: Transactions retrieved successfully content: application/json: schema: $ref: '#/components/schemas/ExternalApiTransactionsResponse' '400': description: >- Invalid query parameters. Error code: INVALID_REQUEST (invalid cursor format or limit out of range 1–100) content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' '401': description: Authentication failed content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' '403': description: Access denied content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' '404': description: No account found content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' '500': description: Internal server error content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' security: - AccessId: [] PoPChallenge: [] PoPFormat: [] PoPSignature: [] components: schemas: ExternalApiTransactionsResponse: type: object required: - transactions properties: next_cursor: type: - string - 'null' description: >- Cursor for the next page of results. Null when there are no more results. transactions: type: array items: $ref: '#/components/schemas/ExternalApiTransactionDto' description: List of transactions matching the query filters. ErrorResponse: type: object required: - error - timestamp properties: error: $ref: '#/components/schemas/ErrorDetails' description: Error payload. timestamp: type: string format: date-time description: ISO 8601 / RFC 3339 UTC timestamp of when the error occurred. example: '2026-05-28T14:30:00Z' ExternalApiTransactionDto: type: object required: - id - type - status - category - amount_in_cents - end_to_end_id - description - created_at - details properties: amount_in_cents: type: integer format: int64 description: >- Transaction amount in centavos. Positive for credits, negative for debits. category: $ref: '#/components/schemas/AccountTransactionCategory' description: Transaction category. completed_at: type: - string - 'null' format: date-time description: >- Transaction completion timestamp (UTC, RFC 3339). Null while pending. example: '2026-05-28T14:30:00Z' counterparty: type: - string - 'null' description: Counterparty name, when available. created_at: type: string format: date-time description: Transaction creation timestamp (UTC, RFC 3339). example: '2026-05-28T14:30:00Z' description: type: string description: Human-readable transaction description. details: $ref: '#/components/schemas/ExternalApiTransactionDetails' description: Type-specific transaction details. end_to_end_id: type: string description: >- End-to-End (E2E) identifier of the PIX in the Central Bank's Instant Payment System. Format: `E{ISPB}{YYYYMMDD}{HHmmss}{UniqueID}` (e.g.: E323070002024011012345612345678901234). Used for tracking, reconciliation, and proof of PIX transactions. example: E323070002024011012345612345678901234 id: type: integer format: int64 description: Transaction identifier. med: oneOf: - type: 'null' - $ref: '#/components/schemas/ExternalApiTransactionMedInfo' description: MED dispute/infraction context, when applicable. status: $ref: '#/components/schemas/TransactionStatus' description: Transaction status. type: type: string description: Transaction type (e.g., `pix_transfer`, `boleto_payment`). ErrorDetails: type: object required: - code - message properties: code: type: string description: >- Machine-readable error code. Use this for branching logic, not `message`. example: INVALID_REQUEST details: type: object description: >- Optional structured details. For `INVALID_REQUEST`, may be an array of field validation errors or a `validation_failed` object depending on the endpoint. message: type: string description: >- Human-readable error description. Do not rely on this text for programmatic handling. AccountTransactionCategory: type: string enum: - credit - debit - block ExternalApiTransactionDetails: oneOf: - type: object required: - value - type properties: type: type: string enum: - Pix value: $ref: '#/components/schemas/PixDetailsPayload' title: Pix - type: object required: - value - type properties: type: type: string enum: - Boleto value: $ref: '#/components/schemas/BoletoDetailsPayload' title: Boleto - type: object required: - value - type properties: type: type: string enum: - Refund value: $ref: '#/components/schemas/RefundDetailsPayload' title: Refund - type: object required: - value - type properties: type: type: string enum: - Judicial value: $ref: '#/components/schemas/JudicialDetailsResponse' title: Judicial - type: object required: - value - type properties: type: type: string enum: - Med value: $ref: '#/components/schemas/ExternalApiMedDetails' title: Med ExternalApiTransactionMedInfo: type: object required: - can_be_disputed properties: can_be_disputed: type: boolean incoming_infraction: oneOf: - type: 'null' - $ref: '#/components/schemas/ExternalApiMedInfraction' outgoing_dispute: oneOf: - type: 'null' - $ref: '#/components/schemas/ExternalApiMedDispute' TransactionStatus: type: string enum: - initial - pending - committed - voided - failed PixDetailsPayload: type: object required: - pix_type - sender - receiver properties: message: type: - string - 'null' pix_key: type: - string - 'null' pix_type: $ref: '#/components/schemas/PixType' receiver: $ref: '#/components/schemas/PartyInfo' sender: $ref: '#/components/schemas/PartyInfo' BoletoDetailsPayload: type: object required: - bar_code - inputtable_line - due_date - sender - receiver - assignor properties: assignor: type: string bar_code: type: string due_date: type: string format: date description: Boleto due date (`YYYY-MM-DD`). example: '2026-06-01' inputtable_line: type: string paid_at: type: - string - 'null' format: date-time description: Payment confirmation timestamp (UTC, RFC 3339). example: '2026-05-28T14:30:00Z' receiver: $ref: '#/components/schemas/PartyInfo' sender: $ref: '#/components/schemas/PartyInfo' RefundDetailsPayload: type: object required: - amount_in_cents - refund_triggered_at - original_transaction_details properties: amount_in_cents: type: integer format: int64 original_transaction_details: $ref: '#/components/schemas/ExternalApiRefundDetails' reason: type: - string - 'null' refund_triggered_at: type: string format: date-time description: Refund initiation timestamp (UTC, RFC 3339). example: '2026-05-28T14:30:00Z' JudicialDetailsResponse: type: object required: - protocol_id - operation_type properties: action_nature_type: oneOf: - type: 'null' - $ref: '#/components/schemas/ActionNatureType' judicial_process_number: type: - string - 'null' operation_type: $ref: '#/components/schemas/JudicialOperationType' protocol_id: type: string ExternalApiMedDetails: type: object required: - operation_type - infraction_id - infraction_external_id - original_end_to_end_id properties: infraction_external_id: type: string infraction_id: type: integer format: int64 is_root_receiver: type: - boolean - 'null' operation_type: $ref: '#/components/schemas/MedOperationType' original_end_to_end_id: type: string original_pix_details: oneOf: - type: 'null' - $ref: '#/components/schemas/PixDetailsPayload' description: >- Original cashin context for Return (root receiver). Counterparty CPF is masked. pix_details: oneOf: - type: 'null' - $ref: '#/components/schemas/PixDetailsPayload' description: >- Role-swapped PIX payload SPI uses for the Return pacs.008 path. Counterparty CPF is masked. ExternalApiMedInfraction: type: object required: - id - transaction_id - end_to_end_id - status - original_amount_in_cents - refunded_amount_in_cents - created_at - original_transaction properties: created_at: type: string format: date-time description: Infraction creation timestamp (UTC, RFC 3339). example: '2026-05-28T14:30:00Z' deadline: type: - string - 'null' format: date-time description: >- Response deadline (UTC, RFC 3339). Derived from funds recovery `external_created_at` + 7 days when available. example: '2026-05-28T14:30:00Z' end_to_end_id: type: string funds_recovery: oneOf: - type: 'null' - $ref: '#/components/schemas/ExternalApiMedFundsRecovery' id: type: integer format: int64 original_amount_in_cents: type: integer format: int64 original_transaction: $ref: '#/components/schemas/ExternalApiMedOriginalTransactionSummary' refunded_amount_in_cents: type: integer format: int64 status: $ref: '#/components/schemas/PublicMedInfractionStatus' transaction_id: type: integer format: int64 ExternalApiMedDispute: type: object required: - id - transaction_id - end_to_end_id - status - infraction_status - original_amount_in_cents - refunded_amount_in_cents - created_at - original_transaction properties: cancellation_requested_at: type: - string - 'null' format: date-time description: Timestamp when cancellation was requested (UTC, RFC 3339). example: '2026-05-28T14:30:00Z' created_at: type: string format: date-time description: Dispute creation timestamp (UTC, RFC 3339). example: '2026-05-28T14:30:00Z' deadline: type: - string - 'null' format: date-time description: >- Response deadline (UTC, RFC 3339). Derived from funds recovery `external_created_at` + 7 days when available. example: '2026-05-28T14:30:00Z' end_to_end_id: type: string funds_recovery: oneOf: - type: 'null' - $ref: '#/components/schemas/ExternalApiMedFundsRecovery' id: type: integer format: int64 infraction_status: $ref: '#/components/schemas/OutgoingInfractionStatus' description: >- How the contested PSPs analysed the contestation — orthogonal to `status`. original_amount_in_cents: type: integer format: int64 original_transaction: $ref: '#/components/schemas/ExternalApiMedOriginalTransactionSummary' refunded_amount_in_cents: type: integer format: int64 status: $ref: '#/components/schemas/PublicMedDisputeStatus' transaction_id: type: integer format: int64 PixType: type: string enum: - Manual - Key - QRCode PartyInfo: type: object required: - name - document - bank - bank_code - account_number - account_type properties: account_number: type: string account_type: $ref: '#/components/schemas/AccountType' bank: type: string bank_code: type: string document: type: string name: type: string ExternalApiRefundDetails: oneOf: - type: object required: - value - type properties: type: type: string enum: - Pix value: $ref: '#/components/schemas/PixDetailsPayload' title: Pix - type: object required: - value - type properties: type: type: string enum: - Boleto value: $ref: '#/components/schemas/BoletoDetailsPayload' title: Boleto ActionNatureType: type: string enum: - civil - criminal - labor - fiscal - alimentary JudicialOperationType: type: string enum: - Block - Unblock - Return MedOperationType: type: string enum: - Block - Unblock - Return ExternalApiMedFundsRecovery: type: object required: - external_id - status properties: closed_at: type: - string - 'null' format: date-time description: BACEN funds recovery closure timestamp (UTC, RFC 3339). example: '2026-05-28T14:30:00Z' contact_email: type: - string - 'null' contact_phone: type: - string - 'null' external_created_at: type: - string - 'null' format: date-time description: BACEN funds recovery creation timestamp (UTC, RFC 3339). example: '2026-05-28T14:30:00Z' external_id: type: string external_last_modified_at: type: - string - 'null' format: date-time description: BACEN funds recovery last modification timestamp (UTC, RFC 3339). example: '2026-05-28T14:30:00Z' report_details: type: - string - 'null' reporter_participant: type: - string - 'null' root_transaction_id: type: - string - 'null' situation_type: oneOf: - type: 'null' - $ref: '#/components/schemas/MedOriginType' status: $ref: '#/components/schemas/MedFundsRecoveryStatus' ExternalApiMedOriginalTransactionSummary: type: object required: - created_at properties: counterparty_name: type: - string - 'null' created_at: type: string format: date-time description: Original transaction creation timestamp (UTC, RFC 3339). example: '2026-05-28T14:30:00Z' PublicMedInfractionStatus: type: string enum: - pending - completed - cancelled OutgoingInfractionStatus: type: string description: >- Derived, per-dispute view of how the contested PSPs analysed the contestation. Computed from the dispute's linked `med_outgoing_infractions` enum: - pending - accepted - rejected - cancelled PublicMedDisputeStatus: type: string enum: - pending - completed - cancelled AccountType: type: string enum: - checking_account - savings_account - prepaid_payment_account - payment_account MedOriginType: type: string description: |- Situation type from DICT API (SituationType). Set by the creator PSP when creating the Recuperação de Valores. enum: - scam_fraud - unauthorized_transaction - coercion_crime - fraudulent_access - others - unknown MedFundsRecoveryStatus: type: string enum: - created - tracked - awaiting_analysis - analysed - refunding - completed - cancelled securitySchemes: AccessId: type: apiKey in: header name: x-access-id description: UUID of the service account (e.g., 550e8400-e29b-41d4-a716-446655440000) PoPChallenge: type: apiKey in: header name: X-PoP-Challenge description: >- Unix timestamp in milliseconds (e.g., 1704636800000). Must be within 5 minutes of server time. PoPFormat: type: apiKey in: header name: X-PoP-Format description: Must be 'service-account' for service account authentication PoPSignature: type: apiKey in: header name: X-PoP-Signature description: >- EdDSA signature of the request in base64 format. Signs: uri:method:body:timestamp ````