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

# Get operations with transaction details

> Retrieves operations with transaction details from BigQuery. Supports filtering by date range, operation type, and transaction status.

**Backwards Compatibility**: When no pagination parameters (page, pageSize) are provided, returns simple format: `{ data: [...] }`. When pagination parameters are provided, returns format with metadata: `{ data: [...], pagination: {...} }`.



## OpenAPI

````yaml /openapi/openapi.json get /api/operations
openapi: 3.0.0
info:
  title: FinSync API Documentation
  version: 1.0.0
  description: API documentation for FinSync application
  contact:
    name: FinSync Support
    email: support@finsync.com
servers:
  - url: https://finsync.ar
    description: API server
security:
  - apiKey: []
tags:
  - name: Clients
    description: Operations related to clients and their accounts
  - name: Accounts
    description: Operations related to account balances
  - name: Operations
    description: Operations for creating and managing financial operations
  - name: Operation Types
    description: Company operation types management
  - name: Transaction Types
    description: Company transaction types management
  - name: Superadmin
    description: Cross-tenant operations (JWT + email allowlist)
  - name: External client
    description: >-
      Exports for external (portal-linked) clients. Authenticate with
      `x-api-key` (company-owned client ID) or `Authorization: Bearer` (Supabase
      access token with an ExternalClient invite).
paths:
  /api/operations:
    get:
      tags:
        - Operations
      summary: Get operations with transaction details
      description: >-
        Retrieves operations with transaction details from BigQuery. Supports
        filtering by date range, operation type, and transaction status.


        **Backwards Compatibility**: When no pagination parameters (page,
        pageSize) are provided, returns simple format: `{ data: [...] }`. When
        pagination parameters are provided, returns format with metadata: `{
        data: [...], pagination: {...} }`.
      parameters:
        - in: query
          name: dateFrom
          schema:
            type: string
            format: date
          description: Start date for filtering operations (defaults to yesterday)
        - in: query
          name: dateTo
          schema:
            type: string
            format: date
          description: End date for filtering operations (defaults to today)
        - in: query
          name: page
          schema:
            type: integer
            default: 1
          description: Page number for pagination
        - in: query
          name: pageSize
          schema:
            type: integer
            default: 10
            maximum: 100
          description: Number of items per page (max 100)
        - in: query
          name: operationType
          schema:
            type: string
            enum:
              - up
              - down
              - other
              - exchange
              - budget
              - interest
          description: Filter by operation type
        - in: query
          name: status
          schema:
            type: string
            enum:
              - pending
              - completed
              - adjusted
          description: Filter by transaction status
      responses:
        '200':
          description: Paginated list of operations with transaction details
          content:
            application/json:
              schema:
                type: object
                properties:
                  data:
                    type: array
                    items:
                      type: object
                      properties:
                        operation_id:
                          type: integer
                        company_id:
                          type: integer
                        operation_description:
                          type: string
                          nullable: true
                        operation_type_name:
                          type: string
                        operation_type:
                          type: string
                          enum:
                            - up
                            - down
                            - other
                            - exchange
                            - budget
                            - interest
                        operation_created_at:
                          type: string
                          format: date-time
                        total_transactions:
                          type: integer
                        total_credito_amount:
                          type: number
                        total_debito_amount:
                          type: number
                        trx:
                          type: array
                          items:
                            type: object
                            properties:
                              transaction_id:
                                type: integer
                              amount:
                                type: number
                              status:
                                type: string
                                enum:
                                  - pending
                                  - completed
                                  - adjusted
                              transaction_type:
                                type: string
                                enum:
                                  - credit
                                  - debit
                              account_name:
                                type: string
                              currency_name:
                                type: string
                              client_name:
                                type: string
                  pagination:
                    type: object
                    properties:
                      page:
                        type: integer
                      pageSize:
                        type: integer
                      total:
                        type: integer
                      totalPages:
                        type: integer
        '401':
          description: Unauthorized - Missing or invalid authentication
        '500':
          description: Server error
      security:
        - apiKey: []
components:
  securitySchemes:
    apiKey:
      type: apiKey
      in: header
      name: x-api-key
      description: API Key for authentication

````