Search
K
9fin Instruments (Private Credit) API

Instrument

object
amountAny Of
required

Principal amount of the instrument, with values converted across currencies and expressed as a range.

CurrencyRangeobject

A monetary value as a range, converted into each major currency.

The same underlying amount is provided in EUR, GBP and USD for convenience,
alongside the original currency and value as reported.

Show Child Parameters
benchmarkAny Of
required

Reference benchmark rate the margin is set over (e.g. SOFR, EURIBOR).

Variant 1string
borrower_advisorsAny Of
required

Non-legal advisers (e.g. financial or M&A advisers) acting for the borrower.

Advisorarray[object]
Show Child Parameters
borrower_legal_advisorAny Of
required

Law firm advising the borrower on the financing.

LegalAdvisorobject
Show Child Parameters
companyAny Of
required

The borrowing company that the instrument finances.

Companyobject
Show Child Parameters
cov_liteAny Of
required

Whether the instrument is covenant-lite (lacks maintenance covenants).

Variant 1boolean
currencyAny Of
required

Currency in which the instrument is denominated.

Currencyobject
Show Child Parameters
debt_purposeAny Of
required

Intended use(s) of proceeds (e.g. acquisition, refinancing, dividend recap).

Variant 1array[string]
debt_securityAny Of
required

Type of debt security (e.g. term loan, senior secured notes).

DebtSecurityobject
Show Child Parameters
governing_lawAny Of
required

Jurisdiction whose law governs the instrument’s documentation.

Variant 1string
is_greenAny Of
required

Whether the instrument is a green financing (proceeds earmarked for environmental projects).

Variant 1boolean
is_sponsor_dealAny Of
required

Whether the financing backs a private-equity-sponsored borrower.

Variant 1boolean
is_sustainability_linkedAny Of
required

Whether the instrument’s terms are linked to sustainability performance targets.

Variant 1boolean
is_tap_dealAny Of
required

Whether the instrument is a tap (an add-on to an existing issuance).

Variant 1boolean
issue_dateAny Of
required

Date the instrument was issued, expressed as a range to reflect uncertainty or marketed windows.

DateRangeobject

A date expressed as a (possibly open-ended) range.

Used where a date is only known to fall within a window rather than on an
exact day.

Show Child Parameters
issue_priceAny Of
required

Issue price as a percentage of par, expressed as a range.

FloatRangeobject

A numeric value expressed as a (possibly open-ended) range.

Marketed metrics are frequently disclosed as ranges rather than exact
figures, so values are represented by their bounds and whether each bound
is inclusive.

Show Child Parameters
issuer_entityAny Of
required

Legal entity that issues or borrows under the instrument.

IssuerEntityobject
Show Child Parameters
lender_advisorsAny Of
required

Non-legal advisers (e.g. financial or M&A advisers) acting for the lender(s).

Advisorarray[object]
Show Child Parameters
lender_legal_advisorAny Of
required

Law firm advising the lender(s) on the financing.

LegalAdvisorobject
Show Child Parameters
lendersAny Of
required

Names of the lenders providing the financing.

Variant 1array[string]
marginAny Of
required

Interest margin (spread) over the benchmark rate, in basis points, expressed as a range.

FloatRangeobject

A numeric value expressed as a (possibly open-ended) range.

Marketed metrics are frequently disclosed as ranges rather than exact
figures, so values are represented by their bounds and whether each bound
is inclusive.

Show Child Parameters
marketed_capexAny Of
required

Capital expenditure figure marketed to lenders, with values converted across currencies and expressed as a range.

CurrencyRangeobject

A monetary value as a range, converted into each major currency.

The same underlying amount is provided in EUR, GBP and USD for convenience,
alongside the original currency and value as reported.

Show Child Parameters
marketed_capex_as_percentage_of_salesAny Of
required

Marketed capital expenditure as a percentage of sales, expressed as a range.

FloatRangeobject

A numeric value expressed as a (possibly open-ended) range.

Marketed metrics are frequently disclosed as ranges rather than exact
figures, so values are represented by their bounds and whether each bound
is inclusive.

Show Child Parameters
marketed_ebitdaAny Of
required

EBITDA figure marketed to lenders, with values converted across currencies and expressed as a range.

CurrencyRangeobject

A monetary value as a range, converted into each major currency.

The same underlying amount is provided in EUR, GBP and USD for convenience,
alongside the original currency and value as reported.

Show Child Parameters
marketed_ebitda_as_percentage_of_marginAny Of
required

Marketed EBITDA margin (EBITDA as a percentage of sales), expressed as a range.

FloatRangeobject

A numeric value expressed as a (possibly open-ended) range.

Marketed metrics are frequently disclosed as ranges rather than exact
figures, so values are represented by their bounds and whether each bound
is inclusive.

Show Child Parameters
marketed_interest_coverageAny Of
required

Marketed interest coverage ratio (EBITDA / interest expense), expressed as a range.

FloatRangeobject

A numeric value expressed as a (possibly open-ended) range.

Marketed metrics are frequently disclosed as ranges rather than exact
figures, so values are represented by their bounds and whether each bound
is inclusive.

Show Child Parameters
marketed_salesAny Of
required

Sales/revenue figure marketed to lenders, with values converted across currencies and expressed as a range.

CurrencyRangeobject

A monetary value as a range, converted into each major currency.

The same underlying amount is provided in EUR, GBP and USD for convenience,
alongside the original currency and value as reported.

Show Child Parameters
marketed_senior_gross_leverageAny Of
required

Marketed senior gross leverage multiple (senior debt / EBITDA), expressed as a range.

FloatRangeobject

A numeric value expressed as a (possibly open-ended) range.

Marketed metrics are frequently disclosed as ranges rather than exact
figures, so values are represented by their bounds and whether each bound
is inclusive.

Show Child Parameters
marketed_senior_net_leverageAny Of
required

Marketed senior net leverage multiple (senior debt net of cash / EBITDA), expressed as a range.

FloatRangeobject

A numeric value expressed as a (possibly open-ended) range.

Marketed metrics are frequently disclosed as ranges rather than exact
figures, so values are represented by their bounds and whether each bound
is inclusive.

Show Child Parameters
marketed_total_gross_leverageAny Of
required

Marketed total gross leverage multiple (total debt / EBITDA), expressed as a range.

FloatRangeobject

A numeric value expressed as a (possibly open-ended) range.

Marketed metrics are frequently disclosed as ranges rather than exact
figures, so values are represented by their bounds and whether each bound
is inclusive.

Show Child Parameters
marketed_total_net_leverageAny Of
required

Marketed total net leverage multiple (total debt net of cash / EBITDA), expressed as a range.

FloatRangeobject

A numeric value expressed as a (possibly open-ended) range.

Marketed metrics are frequently disclosed as ranges rather than exact
figures, so values are represented by their bounds and whether each bound
is inclusive.

Show Child Parameters
maturityAny Of
required

Date the instrument matures, expressed as a range to reflect uncertainty or marketed windows.

DateRangeobject

A date expressed as a (possibly open-ended) range.

Used where a date is only known to fall within a window rather than on an
exact day.

Show Child Parameters
nf_idstringrequired

9Fin ID for this instrument. Unique for all instruments and across APIs.

pik_couponAny Of
required

Payment-in-kind (PIK) coupon rate, expressed as a range.

FloatRangeobject

A numeric value expressed as a (possibly open-ended) range.

Marketed metrics are frequently disclosed as ranges rather than exact
figures, so values are represented by their bounds and whether each bound
is inclusive.

Show Child Parameters
portabilityAny Of
required

Whether the debt is portable (can survive a change of control of the borrower).

Variant 1boolean
redeemedAny Of
required

Whether the instrument has been redeemed/repaid.

Variant 1boolean
reporting_period_currencyAny Of
required

Currency in which the issuer’s reported financials are expressed.

Currencyobject
Show Child Parameters
reporting_period_dateAny Of
required

End date of the financial reporting period the marketed figures relate to.

Variant 1string(date)
reporting_typeAny Of
required

Type of financial reporting the marketed figures are based on (e.g. last twelve months, annual).

Variant 1string
sourcesAny Of
required

Sources from which the instrument’s data was obtained.

Variant 1array[string]
sponsorsAny Of
required

Private equity sponsor(s) backing the borrower, where applicable.

Sponsorarray[object]
Show Child Parameters
statusAny Of
required

Current lifecycle status of the instrument (e.g. announced, priced, closed).

Variant 1string
tenorAny Of
required

Tenor of the instrument in years, expressed as a range.

FloatRangeobject

A numeric value expressed as a (possibly open-ended) range.

Marketed metrics are frequently disclosed as ranges rather than exact
figures, so values are represented by their bounds and whether each bound
is inclusive.

Show Child Parameters
Example