New Light partners with Greenstep to bring agentic finance to the NordicsLight partners with Greenstep Read the announcement

List the ledger lines to match bank transactions with

GET
https://api.light.inc/v1/bank-accounts/{bankAccountId}/ledger-transaction-lines

Returns the ledger transaction lines posted to this bank account's ledger account, each with its reconciliationStatus and, once matched, its matchingGroupId. Filter on reconciliationStatus:eq:UNMATCHED for the lines reconcile-transactions accepts. Reversed transactions and their reversals are left out, as on the bank reconciliation page. Sorted by newest posting date first unless sort is given. The dcSign and transactionCurrency filters read amounts.dcSign and amounts.transactionCurrency. Fails with 404 when the bank account doesn't exist or the API key can't access its entity.

Authorization

Send one of these on every request. See Authentication for how to get credentials.

  • API key

    Basic authentication header of the form Basic <api_key>, where <api_key> is your api key.

  • Bearer token

Path parameters

  • bankAccountId string · uuidrequired

Query parameters

  • sort string

    Sort string in the format field:direction. To provide multiple sort fields, separate them with commas.

    Available directions: asc, desc.

    Available fields: postingDate.

  • filter string

    Filter string in the format field:operator:value. To provide multiple filters, separate them with commas.

    Available operators: eq, ne, in, not_in, gt, gte, lt, lte.

    • For in and not_in operators, provide multiple values separated by the pipe character (|).

    Available fields: dcSign, id, matchingGroupId, postingDate, reconciliationStatus, transactionCurrency.

  • limit integer · int32

    Maximum number of items to return. Default is 50, maximum is 200.

  • offset integer · int64deprecated

    Number of items to skip before starting to collect the result set. Deprecated, use 'cursor' instead.

  • cursor string

    The cursor position to start returning results from. To opt-in into cursor-based pagination, provide 0 for the initial request. For subsequent requests, use nextCursor and prevCursor from the previous response to navigate. Cursor values are opaque and should not be constructed manually.

Response

  • records array of object

    List of records for the current page

    • id string · uuid

      ID of the ledger transaction line; the ID to match with

    • ledgerTransactionId string · uuid

      ID of the ledger transaction the line belongs to

    • accountingDocumentId string · uuid

      ID of the accounting document that posted the line

    • accountingDocumentNumber string

      Number of the accounting document

    • documentType string

      Type of the accounting document

      ⚠️ This enum is not exhaustive; new values may be added in the future.

      One of AP AR BP CC CN CT DE FX JE YC

    • postingDate string · date

      Posting date of the line

    • description string

      Description of the line

    • amounts object

      • dcSign string

        ⚠️ This enum is not exhaustive; new values may be added in the future.

        Note

        D or C. Redundant with the sign of signedLocalAmount (D is negative there) and with debit/credit.

        One of D C

      • transactionAmount integer · int64

        Note

        Unsigned magnitude. The direction lives in the sign of signedTransactionAmount, not here.

      • transactionAmountInMajors number

        Note

        transactionAmount as a decimal, unsigned. For display, not arithmetic.

      • signedTransactionAmount integer · int64

        Note

        Credit-positive: a credit is positive, a debit is negative, in minor units. This is the opposite polarity to the balances GET /v1/general-ledger-summary returns, which are debit-positive — reconciling one against the other means flipping the sign on one side. There is no InMajors counterpart to this field; the unsigned *InMajors value beside it carries the magnitude only.

      • transactionCurrency string

        Note

        The document's currency. null on lines with no transaction amount: rounding, revaluation and translation-adjustment lines.

      • localAmount integer · int64

        Note

        Unsigned magnitude. The direction lives in the sign of signedLocalAmount, not here.

      • localAmountInMajors number

        Note

        localAmount as a decimal, unsigned.

      • signedLocalAmount integer · int64

        Note

        Credit-positive: a credit is positive, a debit is negative, in minor units. This is the opposite polarity to the balances GET /v1/general-ledger-summary returns, which are debit-positive — reconciling one against the other means flipping the sign on one side. There is no InMajors counterpart to this field; the unsigned *InMajors value beside it carries the magnitude only.

      • localCurrency string

        Note

        The entity's local currency.

      • groupAmount integer · int64

        Note

        Unsigned magnitude. The direction lives in the sign of signedGroupAmount, not here.

      • groupAmountInMajors number

        Note

        groupAmount as a decimal, unsigned.

      • signedGroupAmount integer · int64

        Note

        Credit-positive: a credit is positive, a debit is negative, in minor units. This is the opposite polarity to the balances GET /v1/general-ledger-summary returns, which are debit-positive — reconciling one against the other means flipping the sign on one side. There is no InMajors counterpart to this field; the unsigned *InMajors value beside it carries the magnitude only.

      • groupCurrency string

        Note

        The company's group currency, the same on every line.

      • debit boolean

        Note

        true on a debit line. Redundant with dcSign and with a negative signedLocalAmount.

      • credit boolean

        Note

        true on a credit line. Redundant with dcSign and with a positive signedLocalAmount.

    • businessPartnerName string

      Name of the vendor or customer of the document

    • reconciliationStatus string

      Whether the line is matched with bank transactions, excluded from reconciliation, or neither

      ⚠️ This enum is not exhaustive; new values may be added in the future.

      One of EXCLUDED MATCHED UNMATCHED

    • matchingGroupId string · uuid

      ID of the matching group the line is in, when it is matched

    • matchedAt string · date-time

      When the line was matched

  • hasMore boolean

    Boolean flag indicating if there are more records available

  • total integer · int64deprecated

    Total number of records (only for offset pagination). This field is not guaranteed to be returned and only available for offset pagination, please do not rely on it and migrate to cursor pagination.

  • nextCursor string

    Cursor for fetching the next page (only for cursor pagination)

  • prevCursor string

    Cursor for fetching the previous page (only for cursor pagination)