> ## Documentation Index > Fetch the complete documentation index at: https://docs.chift.eu/llms.txt > Use this file to discover all available pages before exploring further. # Get list of financial transactions > Returns the list of transactions of an account ## OpenAPI ````yaml get /consumers/{consumer_id}/banking/transactions openapi: 3.1.0 info: title: Chift API description: >- The Chift API is a universal API giving you access to financial data from the software of your clients. It helps software companies to offer native integrations to their clients without the effort needed to maintain those native integrations. By using the APIs (Accounting, POS, eCommerce) of Chift, you connect once and allow your clients to use their software packages. version: 1.0.0 servers: - url: https://api.chift.eu description: Chift security: - bearerAuth: [] paths: /consumers/{consumer_id}/banking/transactions: get: tags: - Banking - Transactions summary: Get list of financial transactions description: Returns the list of transactions of an account operationId: banking_get_account_transactions parameters: - name: consumer_id in: path required: true schema: type: string format: uuid title: Consumer Id - name: page in: query required: false schema: type: integer minimum: 1 default: 1 title: Page description: Page number - name: size in: query required: false schema: type: integer maximum: 100 minimum: 1 default: 50 title: Size description: Page size - name: account_id in: query required: true schema: type: string title: Account Id - name: date_from in: query required: false schema: anyOf: - type: string format: date - type: 'null' title: Date From - name: date_to in: query required: false schema: anyOf: - type: string format: date - type: 'null' title: Date To - name: date_type in: query required: false schema: anyOf: - $ref: '#/components/schemas/TransactionFilterDateType' - type: 'null' default: value_date title: Date Type - name: updated_after in: query required: false schema: anyOf: - type: string format: date - type: 'null' title: Updated After responses: '200': description: Successful Response content: application/json: schema: $ref: '#/components/schemas/ChiftPage_BankingTransactionItem_' '400': content: application/json: example: message: Error while trying to perform your request status: error schema: $ref: '#/components/schemas/ChiftError' description: Bad Request '422': description: Validation Error content: application/json: schema: $ref: '#/components/schemas/HTTPValidationError' security: - mcp_auth: - banking - banking.read - banking.transactions - banking.transactions.read components: schemas: TransactionFilterDateType: type: string enum: - value_date - execution_date title: TransactionFilterDateType ChiftPage_BankingTransactionItem_: properties: items: items: $ref: '#/components/schemas/BankingTransactionItem' type: array title: Items total: type: integer minimum: 0 title: Total page: type: integer minimum: 1 title: Page size: type: integer minimum: 1 title: Size type: object required: - items - total - page - size title: ChiftPage[BankingTransactionItem] ChiftError: properties: message: type: string title: Message status: anyOf: - type: string - type: 'null' title: Status default: error detail: anyOf: - type: string - type: 'null' title: Detail default: '' type: object required: - message title: ChiftError HTTPValidationError: title: Validation Error required: - message type: object properties: message: title: Message type: string default: Validation error status: title: Status type: string default: error detail: title: Detail type: array items: $ref: '#/components/schemas/ValidationError' BankingTransactionItem: properties: id: type: string title: Id description: Unique identifier of the transaction examples: - transaction-123 bank_account_id: anyOf: - type: string - type: 'null' title: Bank Account Id description: Identifier of the bank account linked to the transaction examples: - account-123 amount: type: number title: Amount description: Amount of the transaction examples: - 1000 tax_amount: anyOf: - type: number - type: 'null' title: Tax Amount description: VAT amount of the transaction examples: - 200 currency: type: string title: Currency description: Currency of the transaction examples: - EUR description: anyOf: - type: string - type: 'null' title: Description description: Description of the transaction examples: - Chift transaction additional_information: anyOf: - type: string - type: 'null' title: Additional Information description: Additional information of the transaction examples: - Chift transaction counterpart_name: anyOf: - type: string - type: 'null' title: Counterpart Name description: Name of the counterpart examples: - John Doe counterpart_reference: anyOf: - type: string - type: 'null' title: Counterpart Reference description: Reference of the counterpart examples: - FR76300040123456789012345678 remittance_information: anyOf: - type: string - type: 'null' title: Remittance Information description: Remittance information of the transaction examples: - Chift transaction creation_date: type: string format: date-time title: Creation Date description: Creation date of the transaction examples: - '2025-01-01T00:00:00Z' value_date: type: string format: date-time title: Value Date description: Value date of the transaction examples: - '2025-01-01T00:00:00Z' execution_date: type: string format: date-time title: Execution Date description: Execution date of the transaction examples: - '2025-01-01T00:00:00Z' internal_transaction: anyOf: - type: boolean - type: 'null' title: Internal Transaction description: Indicates if the transaction is internal default: false examples: - false operation_type: anyOf: - $ref: '#/components/schemas/OperationType' - type: 'null' description: Type of the operation default: other examples: - incoming_transfer last_update_on: anyOf: - type: string format: date-time - type: 'null' title: Last Update On description: Last update date of the transaction examples: - '2025-01-01T00:00:00Z' status: anyOf: - $ref: '#/components/schemas/BankingTransactionStatus' - type: 'null' description: Status of the transaction examples: - pending open_balance: anyOf: - type: number - type: 'null' title: Open Balance description: Opening balance of the account at the time of the transaction examples: - 1000 attachments_info: $ref: '#/components/schemas/ItemAttachmentInfoOut' description: Extra information about the attachments linked to the invoice. type: object required: - id - amount - currency - creation_date - value_date - execution_date title: BankingTransactionItem ValidationError: properties: loc: items: anyOf: - type: string - type: integer type: array title: Location msg: type: string title: Message type: type: string title: Error Type input: title: Input ctx: type: object title: Context type: object required: - loc - msg - type title: ValidationError OperationType: type: string enum: - incoming_transfer - outgoing_transfer - card - direct_debit - direct_debit_collection - direct_debit_hold - fee - cheque - recall - swift_income - pay_later - financing_installment - cashback - interest - other title: OperationType BankingTransactionStatus: type: string enum: - pending - declined - completed title: BankingTransactionStatus ItemAttachmentInfoOut: properties: status: $ref: '#/components/schemas/ItemAttachmentInfoStatus' description: >- Indicates whether an attachment (e.g. PDF or image) is available for this entry, and how to retrieve it. 'yes': one or more attachments are available directly — each entry in the attachments array contains a filename and a download URL. 'yes_to_request': an attachment exists but cannot be returned inline. Call GET /accounting/attachments with type and document_id to retrieve the file as a base64-encoded string. The attachments array may be empty in this case. 'no': no attachment is linked to this entry. 'unknown': the connector does not support attachment detection for this provider. attachments: anyOf: - items: $ref: '#/components/schemas/ItemAttachmentInfoAttachment' type: array - type: 'null' title: Attachments description: >- List of attachments available directly for this entry. Populated only when status is 'yes'. When status is 'yes_to_request', this list is empty — use GET /accounting/attachments to fetch the file content. default: [] type: object required: - status title: ItemAttachmentInfoOut ItemAttachmentInfoStatus: type: string enum: - unknown - 'yes' - yes_to_request - 'no' title: ItemAttachmentInfoStatus ItemAttachmentInfoAttachment: properties: filename: anyOf: - type: string - type: 'null' title: Filename description: The name of the attachment. url: anyOf: - type: string - type: 'null' title: Url description: >- Direct download URL for the attachment file. Only populated when the parent attachments_info.status is 'yes'. When status is 'yes_to_request', this field is null and the file must be retrieved via GET /accounting/attachments with the appropriate type and document_id, which returns the content as a base64-encoded string. type: object title: ItemAttachmentInfoAttachment securitySchemes: bearerAuth: type: http scheme: bearer bearerFormat: JWT description: >- This access token needs to be included in each of your request to the Chift API. ````