Skip to content

Loan tape field reference

A loan tape is a scheduled CSV export that delivers loan or payment data to investors, typically over SFTP. This page lists every column that can appear in a tape: the 147 loan-tape fields and the 27 payment-tape fields. These counts match the OpenAPI LoanTapeFields and PaymentTapeFields enums and the field catalog the Admin Portal offers when you build a tape type.

To configure delivery, encryption, file naming, and which fields a tape includes, see Manage loan tapes and loan tape types. To generate a tape scoped to one investor, see the loan-tape API in the Peach API Reference.

Columns are configuration-driven

The 147 loan and 27 payment fields are the full catalog a tape type can draw from — not a fixed column set. Each tape type selects which fields appear and in what order through its loanFields or paymentFields array, so any given tape file contains a subset of these columns in the configured order.

How to read this reference

  • Column header — the field name shown here, unless the tape type remaps it through fieldNameMappings.
  • Type — the semantic type of the value. In the CSV every value is text; the type tells you how to parse it.
  • Money — amounts are emitted in the tape type's configured money unit: minor units (integer cents) by default, or full units (decimal) when the tape type uses fullUnit.
  • Date / Datetime — emitted in ISO 8601.
  • Enum — one of a fixed set of string values; the description lists them.
  • loanMetaData — expands to one column per key configured in the tape type's loanMetaDataFields; it is not a single fixed column.
  • dataStatus — reports per-row data completeness. When a loan's snapshot is missing or incomplete, the row is included with empty values or excluded entirely, depending on the tape type's action-on-missing-data setting (the effective default includes the loan with empty values).

Loan tape fields

The loan tape reports one row per loan as of the report date. Field names are defined by the OpenAPI LoanTapeFields enum; field meanings are derived from the tape data-gatherers in code.

Investor association

FieldTypeDescription
investorIdStringThe unique identifier of the investor (investor is an owner of the account/asset, also called facility in capital market terms).
investorLegalNameStringThe investor legal name.
investorOwnershipPercentageDecimalThe ownership percentage of the account. The format is decimal. For example, 0.01 is 1% ownership and 0.15 is 15% ownership.
secondInvestorIdStringThe unique identifier of the second investor in case two investors split ownership (investor is an owner of the account/asset, also called facility in capital market terms).
secondInvestorLegalNameStringThe second investor legal name.
secondInvestorOwnershipPercentageDecimalThe second investor ownership percentage of the account. The format is decimal. For example, 0.01 is 1% ownership and 0.15 is 15% ownership.

Loan identity and terms

FieldTypeDescription
loanIdStringThe account unique identifier in Peach.
loanStatusEnumThe current status of the account (pending, originated, declined, active, frozen, accelerated, chargedOff, paidOff, canceled).
loanExternalIdStringThe account unique external identifier.
loanTypeEnumThe account type (installment, lineOfCredit, draw).
loanTypeIdStringThe account type (also called asset policies) unique identifier. This is created specifically for each lender's credit product by Peach.
mainBorrowerIdStringThe main borrower unique identifier in Peach.
mainBorrowerExternalIdStringThe main borrower unique external identifier.
activationDateDateThe date the account was activated. On activation date the account status changes from originated to active.
merchantIdStringThe merchant ID recorded on the loan.
merchantBusinessNameStringThe merchant business name recorded on the loan.
originalDurationIntegerThe loan original duration as appears in the agreement.
originalPaymentFrequencyEnumThe loan original payments frequency as appears in the agreement. Possible values are: weekly, everyTwoWeeks, twiceMonthly, monthly.
currentPaymentFrequencyEnumThe current loan payments frequency (weekly, every two weeks, twice a month or monthly).
paidOffDateDateThe date a loan was paid off.
isLoanModifiedBooleantrue if the loan was modified since it was activated. Modification reasons include changes such as: schedule deferral, due date(s) deferral, duration change, reamortization, interest or promo rate change, etc.
projectedPayoffDateDateThe projected payoff date based on the current loan balances (only applicable to installment loans).
remainingDurationIntegerThe remiaining duration of the loan based on the current loan balances (only applicable to installment loans).

Rates and scheduled amounts

FieldTypeDescription
currentCreditLimitMoneyThe account credit limit.
lastDueDateDateThe last due date of the account. The date might change if the account terms changed (e.g. a due date was deferred).
effectiveAPRDecimal (rate)The effective APR.
interestRateDecimal (rate)The annual interest rate effective on the reportDate.
promoRateDecimal (rate)The promo interest rate effective on the reportDate.
contractualRecurringAmountMoneyThe recurring amount as communicated to the borrower in the agreement.
amountFinancedMoneyThe amount financed.
firstDueDateExpectedAmountMoneyThe amount that the borrower is or was expected to pay by the first due date.
firstDueDatePaymentAmountByDueDateMoneyThe actual amount that the borrower paid by the first due date.
upcomingDueDateDateThe upcoming due date.
upcomingDueDateExpectedAmountMoneyThe amount that the borrower is expected to pay by the upcoming due date.
indexRateDecimal (rate)The index rate. Used along with interestRate when "interestType=spread".
interestTypeEnumThe interest type (spread or absolute). Interest rates defined as "spread" will calculate an absolute rate by adding the relative loan rate (aka spread) provided in interestRate to the Index Interest Rate (indexRate) effective on the date the interest is accrued. In case the Index Interest Rate is not set, the system will assume that the Index Interest Rate value is zero on the date the interest is accrued. Interest rates defined as "absolute" will use the value as provided here without adding the Index Interest Rate.
currentRecurringAmountMoneyThe current loan recurring amount. If the loan was reamortized at some point, this value would the most recent amortized recurring amount.
principalAmountMoneyThe principal amount

Balances and fee breakdowns

FieldTypeDescription
outstandingBalanceTotalAmountMoneyThe total outstanding balance sums outstanding principal, interest, and fees. Also called the account payoff amount. If the account status is chargedOff, the amount will be equal to chargedOffPrincipalAmount.
outstandingBalancePrincipalAmountMoneyThe principal portion of the outstandingBalanceTotalAmount.
outstandingBalanceInterestAmountMoneyThe interest portion of the outstandingBalanceTotalAmount.
outstandingBalanceFeesAmountMoneyThe fees portion of the outstandingBalanceTotalAmount.
overdueNumberDaysIntegerThe number of days that the account is overdue.
overdueBalanceTotalAmountMoneyThe account overdue balance.
overdueBalancePrincipalAmountMoneyThe principal portion of the overdue balance.
overdueBalanceInterestAmountMoneyThe interest portion of the overdue balance.
overdueBalanceFeesAmountMoneyThe fees portion of the overdue balance.
dueBalanceTotalAmountMoneyDue balances represent balances that are currently due. The total due balance sums due principal, interest, and fees.
dueBalancePrincipalAmountMoneyThe principal portion of the dueBalanceTotalAmount.
dueBalanceInterestAmountMoneyThe interest portion of the dueBalanceTotalAmount.
dueBalanceFeesAmountMoneyThe fees portion of the dueBalanceTotalAmount.
nonDueBalanceTotalAmountMoneyNon due balances represent balances that are not yet due. The total non-due balance sums non-due principal, interest, and fees.
nonDueBalancePrincipalAmountMoneyThe principal portion of the nonDueBalanceTotalAmount.
nonDueBalanceInterestAmountMoneyThe interest portion of the nonDueBalanceTotalAmount.
nonDueBalanceFeesAmountMoneyThe fees portion of the nonDueBalanceTotalAmount.
overdueOver30DaysBalanceTotalAmountMoneyThe account balance that is over 30 days overdue.
overdueOver60DaysBalanceTotalAmountMoneyThe overdue total amount that is overdue for over 60 days.
overdueOver90DaysBalanceTotalAmountMoneyThe overdue total amount that is overdue for over 90 days.
overdueOver120DaysBalanceTotalAmountMoneyThe overdue total amount that is overdue for over 120 days.
overdueOver150DaysBalanceTotalAmountMoneyThe overdue total amount that is overdue for over 150 days.
overdueOver180DaysBalanceTotalAmountMoneyThe overdue total amount that is overdue for over 180 days.
nonDueBalanceOriginationFeesAmountMoneyThe current non due amount of origination fees.
nonDueBalanceDrawFeesAmountMoneyThe current non due amount of draw fees.
nonDueBalanceLateFeesAmountMoneyThe current non due amount of late fees.
nonDueBalanceModificationFeesAmountMoneyThe current non due amount of modification fees.
dueBalanceOriginationFeesAmountMoneyThe current due amount of origination fees.
dueBalanceDrawFeesAmountMoneyThe current due amount of draw fees.
dueBalanceLateFeesAmountMoneyThe current due amount of late fees.
dueBalanceModificationFeesAmountMoneyThe current due amount of modification fees.
overdueBalanceOriginationFeesAmountMoneyThe overdue amount of origination fees.
overdueBalanceDrawFeesAmountMoneyThe overdue amount of draw fees.
overdueBalanceLateFeesAmountMoneyThe overdue amount of late fees.
overdueBalanceModificationFeesAmountMoneyThe overdue amount of modification fees.
outstandingBalanceOriginationFeesAmountMoneyThe outstanding amount of origination fees.
outstandingBalanceDrawFeesAmountMoneyThe outstanding amount of draw fees.
outstandingBalanceLateFeesAmountMoneyThe outstanding amount of late fees.
outstandingBalanceModificationFeesAmountMoneyThe outstanding amount of modification fees.
nonDueBalanceMembershipFeesAmountMoneyThe membership-fees portion of the non-due balance. Membership-fee feature; gated by a feature flag.
dueBalanceMembershipFeesAmountMoneyThe membership-fees portion of the due balance. Membership-fee feature; gated by a feature flag.
overdueBalanceMembershipFeesAmountMoneyThe membership-fees portion of the overdue balance. Membership-fee feature; gated by a feature flag.
outstandingBalanceMembershipFeesAmountMoneyThe membership-fees portion of the outstanding balance. Membership-fee feature; gated by a feature flag.

Payments, credits, and autopay

FieldTypeDescription
creditsAppliedTotalAmountMoneyThe total amount of service credits applied to the account from the account activation through reportDate.
paymentsMadeTotalAmountMoneyThe total amount of payments applied to the account from the account activation through reportDate.
paymentsMadePrincipalAmountMoneyThe principal portion of payments and credits made (also called principal split).
paymentsMadeInterestAmountMoneyThe interest portion of payments and credits made (also called interest split).
paymentsMadeFeesAmountMoneyThe fees portion of payments and credits made (also called fees split).
paymentsMadeOverAmountMoneyThe amount over paid.
paymentsMadeReimbursementsAmountMoneyThe amount of reimbursements paid.
lastSuccessfulPaymentEffectiveDateDateThe effective date of the most recent successful payment.
lastSuccessfulPaymentTotalAmountMoneyThe amount of the most recent successful payment.
lastSuccessfulPaymentPrincipalAmountMoneyThe principal portion of the most recent successful payment amount (also called payment principal split).
lastSuccessfulPaymentInterestAmountMoneyThe interest portion of the most recent successful payment amount (also called payment interest split).
lastSuccessfulPaymentFeesAmountMoneyThe fees portion of the most recent successful payment amount (also called payment fees split).
isAutopayOnBooleantrue if Autopay is enabled on the account.
recentAutopayAuthorizationDateDateThe most recent date when Autopay was authorized/enabled on the account.
reimbursementAmountMoneyThe amount owed to the borrower.
refundedAmountMoneyThe total amount of refunds applied from account activation date through the reportDate.

Delinquency counters

FieldTypeDescription
isOverdueBooleantrue if the account is overdue.
timesOverdue15DaysIntegerThe number of times the account was overdue more than 15 days.
timesOverdue30DaysIntegerThe number of times the account was overdue more than 30 days.
timesOverdue60DaysIntegerThe number of times the account was overdue more than 60 days.
timesOverdue90DaysIntegerThe number of times the account was overdue more than 90 days.
timesOverdue120DaysIntegerThe number of times the account was overdue more than 120 days.

Charge-off

FieldTypeDescription
isChargedOffBooleantrue if the account was charged off.
chargedOffDateDateThe date when the account was charged off.
chargedOffPrincipalAmountMoneyThe principal portion of the charged off balance. The balance can change if payments were applied after the account was charged off.
chargedOffInterestAmountMoneyThe interest portion of the charged off balance. The balance can change if payments were applied after the account was charged off.
chargedOffFeesAmountMoneyThe fees portion of the charged off balance. The balance can change if payments were applied after the account was charged off.
chargedOffTotalAmountMoneyThe account charged off balance. The balance can change if payments were applied after the account was charged off.
chargedOffReasonEnumThe charge off reason (term, fraudulent, bankruptcy, legal).

Interest accrual, discount, and origination fee

FieldTypeDescription
netInterestAccruedTotalAmountMoneyThe net interest accrued on since the account activation date.
interestDiscountTotalAmountMoneyThe interest discount amount applied since the account activation date.
forgoneInterestCapAmountMoneyThe forgone interest amount because the total accued interest hit the interest cap that was set.
dailyInterestAccruedAmountMoneyThe daily amount of accrued interest.
dailyInterestDiscountAmountMoneyThe daily amount of discounted interest.
dailyForgoneInterestCapAmountMoneyThe daily amount of forgot interest that was forgone due to a defined cap.
originationFeeAmountMoneyThe origination fee amount.

Report, status, and metadata

FieldTypeDescription
reportDateDateThe effective date of the information reported. The amounts and statuses are as of the reportDate end of day.
loanMetaDataDynamicThe loan metadata. Expands to one column per key listed in the tape type's loanMetaDataFields; a key that collides with a standard column is suffixed LoanMetaData.
dataStatusEnumRow-level data-completeness flag computed when the tape row is built (not a snapshot attribute): complete when the loan's snapshot data is fully populated, or missingData when the snapshot is missing or incomplete.

Borrower identity and contact

FieldTypeDescription
mainBorrowerFirstNameStringThe main borrower first name.
mainBorrowerLastNameStringThe main borrower last name.
mainBorrowerDateOfBirthDateThe main borrower date of birth.
mainBorrowerIdentityTypeEnumThe borrower's identity type (SSN, ITIN, passport, driversLicense, taxID, FEIN, stateID, customID).
mainBorrowerIdentityValueStringThe borrower's identity number (SSN, ITIN, tax ID, FEIN, and similar). PII: populated only when the tape is encrypted — set encryptionMethod and publicKey when you create the loan tape. Tokenized at rest.
mainBorrowerIdentityIssuingCountryStringThe country that issued the borrower's primary identity document.
mainBorrowerIdentityIssueDateDateThe date the borrower's primary identity document was issued.
mainBorrowerIdentityExpirationDateDateThe expiration date of the borrower's primary identity document.
mainBorrowerBusinessLegalNameStringThe business legal name (if the borrower is a business.)
mainBorrowerBusinessTypeEnumThe business type (if the borrower is a business.) Values are governed by the BusinessDetails API schema. Possible values are: LLC, cCorporation, sCorporation, generalPartnership, limitedPartnership, soleProprietor, nonProfit, other, cooperative, independentContractor, selfEmployed, veteransOrganization, tribalBusiness, soleTrader, incorporatedAssociation, unincorporatedAssociation, trust, unitTrust, appointorTrust.
currentAddressStateStringThe main borrower home or business address state.
currentAddressPostalCodeStringThe main borrower home or business address postal code.
currentAddressLine1StringThe main borrower home or business address line 1.
currentAddressLine2StringThe main borrower home or business address line 2.
currentAddressCityStringThe main borrower home or business address city.
currentAddressCountryStringThe main borrower home or business address country.
currentEmailStringThe main borrower email.
currentPhoneStringThe main borrower phone.

Compliance: SCRA and bankruptcy

FieldTypeDescription
isInSCRAStatusBooleantrue if the main borrower has an SCRA Case in open status.
activeDutyStartDateDateThe duty start date. This is populated when Peach gets the first hit from the SCRA database.
activeDutyEndDateDateThe duty end date. This is normally populated when duty ends. During ongoing duty, the value will remain empty.
isInBankruptcyBooleantrue if the main borrower has a Bankruptcy Case in open status.
bankruptcyFiledDateDateThe bankruptcy court filing date. This is also when automatic stay is invoked and creditors must stop calling borrowers or making attempts to collect on his or her debt.
bankruptcyCourtCaseNumberStringThe unique identifier the courts use during the filing and review of the bankruptcy.
bankruptcyLastStatusEnumThe latest-reported bankruptcy case status, not case outcome, as it appears in the court (filed, dismissed, discharged, conversion, reinstated, closedFiledInError, closedTransferredOut, closedDischargeNA, closedUndeterminedReason)
bankruptcyDispositionEnumThe outcome of the bankruptcy case decided by the court (dismissed, discharged, reinstated).
bankruptcyChapterEnumThe bankruptcy chapter code (chapter7, chapter9, chapter11, chapter12, chapter13, chapter15, other).

Payment tape fields

The payment tape reports one row per payment-type transaction joined to investor settlements, plus external and external-processor payments. The set of transaction statuses included differs by source: settled transactions include pending, succeeded, chargeback, in-dispute, and failed; external payments include succeeded, chargeback, and failed.

FieldTypeDescription
reportDateDateThe effective date of the information reported. The data includes transactions up to the reportDate end of day.
loanIdStringThe account unique identifier in Peach.
loanExternalIdStringThe account unique external identifier.
investorIdStringThe unique identifier of the investor (investor is an owner of the account/asset, also called facility in capital market terms).
investorLegalNameStringThe investor legal name.
investorOwnershipPercentageDecimalThe ownership percentage of the account. The format is decimal. For example, 0.01 is 1% ownership and 0.15 is 15% ownership.
secondInvestorIdStringThe unique identifier of the second investor in case two investors split ownership (investor is an owner of the account/asset, also called facility in capital market terms).
secondInvestorLegalNameStringThe second investor legal name.
secondInvestorOwnershipPercentageDecimalThe second investor ownership percentage of the account. The format is decimal. For example, 0.01 is 1% ownership and 0.15 is 15% ownership.
transactionIdStringThe transaction unique identifier in Peach.
transactionExternalIdStringThe transaction unique external identifier.
statusEnumThe status of the transaction (pending, succeeded, failed, inDispute, chargeback).
effectiveDateDateThe effective date of the transaction. This is when the transaction was applied to the account.
totalAmountMoneyThe amount of the transaction.
principalAmountMoneyThe principal portion of the transaction amount (also called transaction principal split).
interestAmountMoneyThe interest portion of the transaction amount (also called transaction interest split).
feesAmountMoneyThe fees portion of the transaction amount (also called transaction fees split).
unappliedAmountMoneyIf the transaction amount was greater than the account balance, this amount will represent unapplied portion.
paymentMethodTypeEnumThe transaction method type (ach, debitCard, creditCard, check, cash, payroll, paymentNetwork, moneyOrder, wire).
processingFeeTypeEnumThe type of processing fees - net or gross. If it is a net fee, the amount of the fee is deducted from the amount of the transaction "en route". If it is a gross fee, the amount of the fee is charged by the processor at the end of the month.
processingFeeAmountMoneyTransaction processing fees that are charged by a payment processor.
isReversalBooleantrue means this transaction is a reversal of another transaction.
isReimbursementBooleantrue means this transaction is a reimbursement. Meaning the funds owed to the borrowers were sent in this transaction.
reversingTransactionIdStringPeach unique identifier of the transaction that this transaction reversed.
reversingTransactionExternalIdStringExternal unique identifier of the transaction that this transaction reversed.
settlementIdStringThe settlement batch unique Peach identifier in which the transaction was included.
settlementDateDateThe date of the settlement batch in which the transaction was included.

Field selection, ordering, and money units

A tape type controls how these fields appear:

  • Selection and order — the loanFields / paymentFields array sets which columns appear and in what order. The catalog above is not the column order of any specific tape.
  • Headers — column headers default to the field names above; fieldNameMappings overrides individual headers.
  • Money unitmoneyUnit (subUnit100 for minor units, the default, or fullUnit for decimals) applies to every amount column.

Configure these in the Admin Portal or through the loan-tape API.

See also