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

# Filtrelenmiş banka hareketlerini CSV olarak dışa aktar

> Liste endpointiyle aynı seçim filtrelerini ve sıralamayı kullanır. UTF-8 CSV çıktısında spreadsheet formula injection karakterleri güvenli hâle getirilir ve yapılandırılmış satır sınırı uygulanır.



## OpenAPI

````yaml /openapi/openapi.yaml get /banks/transactions/export
openapi: 3.1.0
info:
  title: Tahsil API
  version: 1.0.0
  description: >-
    Tahsil banka bağlantıları, provider senkronizasyonu, değiştirilemez
    hareketler, zamanlamalar ve hareket otomasyonu için tenant-scoped public API
    sözleşmesi.
servers:
  - url: https://api.tahsil.dev
    description: Production
security:
  - apiKeyAuth: []
    apiSecretAuth: []
tags:
  - name: Sistem - Sağlık
    description: Servis canlılığı ve bağımlılık hazır olma kontrolleri.
  - name: Banka - Bağlantılar
    description: Banka bağlantısı, credential, setup, sync, health ve kullanım işlemleri.
  - name: Banka - Hareketler
    description: >-
      Provider senkronizasyonuyla oluşan değiştirilemez banka hareketleri ve CSV
      dışa aktarımı.
  - name: Banka - Otomasyon
    description: Hareket atamaları, kurallar, preview ve backfill çalışmaları.
  - name: Banka - Zamanlamalar
    description: Banka sorgularının zamanlama ve çalışma durumu yönetimi.
  - name: Banka - Analitik
    description: Tenant kapsamlı dashboard sorgu kataloğu ve analitik sonuçları.
  - name: Denetim - Connector Logları
    description: Maskelenmiş banka connector istek ve yanıt kayıtları.
paths:
  /banks/transactions/export:
    get:
      tags:
        - Banka - Hareketler
      summary: Filtrelenmiş banka hareketlerini CSV olarak dışa aktar
      description: >-
        Liste endpointiyle aynı seçim filtrelerini ve sıralamayı kullanır. UTF-8
        CSV çıktısında spreadsheet formula injection karakterleri güvenli hâle
        getirilir ve yapılandırılmış satır sınırı uygulanır.
      operationId: getBanksTransactionsExport
      parameters:
        - $ref: '#/components/parameters/XCompanyId'
        - $ref: '#/components/parameters/XCompanyIds'
        - name: accountId
          in: query
          description: Banka bağlantısı kimliği.
          schema:
            type: string
        - name: subAccountKey
          in: query
          description: Provider-owned alt hesap kimliği.
          schema:
            type: string
            maxLength: 128
        - name: bankCode
          in: query
          description: Tek banka kodu veya virgülle ayrılmış banka kodları.
          schema:
            type: string
            maxLength: 500
        - name: currency
          in: query
          description: Tek para birimi veya virgülle ayrılmış para birimleri.
          schema:
            type: string
            maxLength: 100
        - name: incoming
          in: query
          description: true gelen, false giden hareketleri seçer.
          schema:
            type: boolean
        - name: status
          in: query
          description: Hareketin aktiflik durumu.
          schema:
            type: boolean
        - name: idNo
          in: query
          description: Provider hareket numarası.
          schema:
            type: string
            maxLength: 100
        - name: iban
          in: query
          description: IBAN ile tam eşleşme.
          schema:
            type: string
            maxLength: 100
        - name: minAmount
          in: query
          description: Dahil en düşük tutar; maxAmount değerini aşamaz.
          schema:
            type: number
        - name: maxAmount
          in: query
          description: Dahil en yüksek tutar.
          schema:
            type: number
        - name: from
          in: query
          description: Dahil başlangıç zamanı; to değerinden sonra olamaz.
          schema:
            type: string
            format: date-time
        - name: to
          in: query
          description: Dahil bitiş zamanı.
          schema:
            type: string
            format: date-time
        - name: dateField
          in: query
          description: Tarih aralığının uygulanacağı alan.
          schema:
            type: string
            enum:
              - transactionDate
              - fetchedAt
            default: transactionDate
        - name: q
          in: query
          description: >-
            Açıklama, ad soyad ve providerStamp alanlarında güvenli metin
            araması.
          schema:
            type: string
            maxLength: 100
        - name: referenceSource
          in: query
          description: >-
            Referans üçlüsünün kaynağı; diğer iki referans alanıyla birlikte
            zorunludur.
          schema:
            type: string
            maxLength: 64
        - name: referenceType
          in: query
          description: Referans varlık türü.
          schema:
            type: string
            maxLength: 64
        - name: referenceId
          in: query
          description: Harici referans kimliği.
          schema:
            type: string
            maxLength: 256
        - name: tag
          in: query
          description: Normalize edilmiş atama etiketi.
          schema:
            type: string
            maxLength: 50
        - name: automationStatus
          in: query
          description: Hareket otomasyonu çalışma durumu.
          schema:
            type: string
            enum:
              - legacy
              - pending
              - processing
              - retry
              - completed
              - dead
        - name: sortBy
          in: query
          description: Sıralama alanı.
          schema:
            type: string
            enum:
              - transactionDate
              - fetchedAt
              - amount
              - balance
            default: transactionDate
        - name: direction
          in: query
          description: Sıralama yönü.
          schema:
            type: string
            enum:
              - asc
              - desc
            default: desc
      responses:
        '200':
          description: UTF-8 CSV export
          content:
            text/csv:
              schema:
                type: string
        '400':
          $ref: '#/components/responses/ErrorResponse'
        '413':
          $ref: '#/components/responses/ErrorResponse'
components:
  parameters:
    XCompanyId:
      name: x-company-id
      in: header
      required: false
      schema:
        type: string
      description: >-
        Hedef firma kimliği. Müşteri banka endpointlerindeki yazma işlemleri
        için zorunludur.
    XCompanyIds:
      name: x-company-ids
      in: header
      required: false
      schema:
        type: string
      description: >-
        API credential tek firma kapsamlıdır; gönderilirse credential firmasıyla
        eşleşen tek kimlik içermelidir.
  responses:
    ErrorResponse:
      description: İstek başarısız oldu.
      content:
        application/json:
          schema:
            type: object
            required:
              - status
            properties:
              status:
                type: boolean
                const: false
              code:
                type: string
                description: >-
                  Kararlı hata kodu; kodlanmış domain ve güvenlik hatalarında
                  döner.
              message:
                type: string
                description: >-
                  İnsan tarafından okunabilir hata açıklaması; mevcutsa
                  entegrasyon kararı için kullanılmamalıdır.
              meta:
                type: object
                additionalProperties: true
              result:
                type: array
                deprecated: true
                description: Legacy Joi doğrulama hatalarında dönen alan listesi.
                items:
                  type: object
                  properties:
                    type:
                      type: string
                    joiType:
                      type: string
                    path:
                      type:
                        - string
                        - number
                    label:
                      type: string
                  additionalProperties: false
              description:
                type: string
            additionalProperties: false
          example:
            status: false
            code: TRANSACTION_AMOUNT_RANGE_INVALID
            message: minAmount, maxAmount değerinden büyük olamaz.
  securitySchemes:
    apiKeyAuth:
      type: apiKey
      in: header
      name: x-api-key
      description: Tenant admin tarafından oluşturulan API anahtarının kimliği.
    apiSecretAuth:
      type: apiKey
      in: header
      name: x-api-secret
      description: >-
        Yalnız oluşturma anında gösterilen API anahtarı secret değeri. x-api-key
        ile aynı istekte gönderilir.

````