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

# Create bank transactions

> Creates bank transactions in batch. Maximum 500 transactions per request. Duplicate transactions (same transactionId for the same bank account) are silently skipped.



## OpenAPI

````yaml /openapi-public.json post /v1/bank-accounts/{bankAccountId}/bank-transactions
openapi: 3.0.1
info:
  title: Light API
  version: 1.0.0
servers: []
security:
  - apiKeyAuth: []
  - bearerAuth: []
paths:
  /v1/bank-accounts/{bankAccountId}/bank-transactions:
    post:
      tags:
        - v1 - Bank Accounts
      summary: Create bank transactions
      description: >-
        Creates bank transactions in batch. Maximum 500 transactions per
        request. Duplicate transactions (same transactionId for the same bank
        account) are silently skipped.
      operationId: createBankTransactions
      parameters:
        - name: bankAccountId
          in: path
          required: true
          schema:
            type: string
            format: uuid
      requestBody:
        content:
          application/json;charset=UTF-8:
            schema:
              $ref: >-
                #/components/schemas/ExternalCreateBankTransactionsRequestV1Model
      responses:
        default:
          description: default response
          content:
            application/json;charset=UTF-8:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/ExternalBankTransactionV1Model'
components:
  schemas:
    ExternalCreateBankTransactionsRequestV1Model:
      required:
        - transactions
      type: object
      properties:
        transactions:
          type: array
          description: List of bank transactions to create. Maximum 500 per request.
          items:
            $ref: '#/components/schemas/ExternalCreateBankTransactionRequestV1Model'
    ExternalBankTransactionV1Model:
      type: object
      properties:
        id:
          type: string
          description: Unique identifier for the bank transaction
          format: uuid
        bankAccountId:
          type: string
          description: ID of the bank account this transaction belongs to
          format: uuid
        date:
          type: string
          description: Transaction date
          format: date
        amount:
          type: integer
          description: Transaction amount in minor units (e.g. cents)
          format: int64
        dcSign:
          type: string
          description: >-
            Debit/credit sign


            ⚠️ This enum is not exhaustive; new values may be added in the
            future.
          nullable: false
          deprecated: false
          enum:
            - D
            - C
        reconciliationStatus:
          type: string
          description: >-
            Reconciliation status


            ⚠️ This enum is not exhaustive; new values may be added in the
            future.
          nullable: false
          deprecated: false
          enum:
            - EXCLUDED
            - MATCHED
            - UNMATCHED
        name:
          type: string
          description: Transaction name / payee
          nullable: true
        memo:
          type: string
          description: Transaction memo / description
          nullable: true
        reference:
          type: string
          description: Transaction reference
          nullable: true
        transactionId:
          type: string
          description: External transaction identifier for idempotency
          nullable: true
        createdAt:
          type: string
          description: Timestamp when the transaction was created
          format: date-time
    ExternalCreateBankTransactionRequestV1Model:
      required:
        - amount
        - date
        - dcSign
      type: object
      properties:
        date:
          type: string
          description: Transaction date
          format: date
        amount:
          type: integer
          description: Transaction amount in minor units (e.g. cents). Must be positive.
          format: int64
        dcSign:
          type: string
          description: >-
            Debit/credit sign. DEBIT for money out, CREDIT for money in.


            ⚠️ This enum is not exhaustive; new values may be added in the
            future.
          nullable: false
          deprecated: false
          enum:
            - D
            - C
        name:
          type: string
          description: Transaction name / payee
          nullable: true
        memo:
          type: string
          description: Transaction memo / description
          nullable: true
        reference:
          type: string
          description: Transaction reference
          nullable: true
        transactionId:
          type: string
          description: >-
            External transaction identifier. Used for idempotency — duplicate
            transactionIds for the same bank account are silently skipped.
          nullable: true
      description: List of bank transactions to create. Maximum 500 per request.
  securitySchemes:
    apiKeyAuth:
      type: apiKey
      description: >-
        Basic authentication header of the form **Basic** **<api_key>**, where
        **<api_key>** is your api key.
      name: Authorization
      in: header
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT

````