Debt instruments

Disclosed debt instruments, printed totals, and disclosure status from 10-K filings.

Category: Financial
Forms: 10-K

Use cases#

Review instrument-level debt terms captured from a filing.
Compare disclosed debt totals with the source disclosure status.

Response schema#

Fields 40

Field path	Type	Description
`disclosure_status`# required	object	Three-state debt disclosure status with evidence.
`disclosure_status.value`# required	string	'disclosed' = at least one issuer-owned debt instrument is disclosed. 'explicitly_none' = the filing explicitly states that no debt or borrowings are outstanding. 'not_disclosed' = no debt disclosure or explicit none-statement is found in scope.
`disclosure_status.evidence`# required	object	Evidence object. Never null.
`disclosure_status.evidence.quote`# required	string\| null	Verbatim excerpt from the filing proving this entry. Shortest contiguous source span; no ellipsis, no translation. null when there is no textual basis.
`disclosure_status.evidence.reasoning`# required	string	How the source maps to this value. For null decisions, state the basis (not disclosed / not applicable / indeterminable / scope limitation).
`instruments`# required	array\| null items: object	One entry per disclosed instrument; null for explicitly_none or not_disclosed.
`instruments[].name`# required	string\| null	Clean identifier without coupon rate or maturity; null for an unlabeled figure row.
`instruments[].category`# required	string	Coarse instrument type from the SEC authority schema.
`instruments[].seniority`# required	string\| null	Seniority only when stated; otherwise null.
`instruments[].secured`# required	string\| null	Security status only when stated; otherwise null.
`instruments[].classification`# required	string\| null	Balance-sheet classification when disclosed; otherwise null.
`instruments[].interest_rate`# required	object	One instrument's stated interest rate. Instrument-level evidence anchors this object.
`instruments[].interest_rate.value`# required	number\| null	Coupon or interest rate as written in percentage points (4.15 means 4.15%; 0 means 0%). For a variable rate, use the stated spread when it is a single number (1.25 for 'SOFR + 1.25%'); null when no rate figure is stated.
`instruments[].interest_rate.unit`# required	string\| null	'percent' when value is present; otherwise null.
`instruments[].interest_rate.rate_type`# required	string\| null	Fixed or variable when determinable from the filing; otherwise null.
`instruments[].interest_rate.basis`# required	string\| null	The rate as printed, verbatim, whenever `value` cannot carry it — a variable-rate basis ('SOFR plus 1.25%') or a fixed-rate range covering several tranches filed under one name ('3.46% - 4.73%'). null when a single figure already sits in `value`, or when the filing states no rate at all.
`instruments[].principal_by_period`# required	array items: object	Outstanding amount for every disclosed period, newest first and on one consistent basis.
`instruments[].principal_by_period[].value`# required	number\| null	Figure as written. A printed zero is 0, not null.
`instruments[].principal_by_period[].unit`# required	string\| null	Currency code inferred from the source context; null when undeterminable.
`instruments[].principal_by_period[].scale`# required	string\| null	'thousands', 'millions', 'billions', or null when absolute.
`instruments[].principal_by_period[].period`# required	object	Balance-sheet date for a disclosed debt amount.
`instruments[].principal_by_period[].period.type`# required	string	Always 'as_of'.
`instruments[].principal_by_period[].period.date`# required	string\| null	ISO 8601 date at the precision printed in the source; null when the source attaches no date.
`instruments[].maturity_date`# required	string\| null	Maturity date at the precision printed in the source; null when absent.
`instruments[].evidence`# required	object	Evidence object. Never null.
`instruments[].evidence.quote`# required	string\| null	Verbatim excerpt from the filing proving this entry. Shortest contiguous source span; no ellipsis, no translation. null when there is no textual basis.
`instruments[].evidence.reasoning`# required	string	How the source maps to this value. For null decisions, state the basis (not disclosed / not applicable / indeterminable / scope limitation).
`totals`# required	array\| null items: object	Printed debt subtotals or totals; null when none are printed.
`totals[].label`# required	string\| null	Printed subtotal label verbatim; null only for an unlabeled figure.
`totals[].classification`# required	string\| null	Classified subtotal, overall total, or null when not classifiable.
`totals[].amounts_by_period`# required	array items: object	Printed amount for every disclosed period, newest first.
`totals[].amounts_by_period[].value`# required	number\| null	Figure as written. A printed zero is 0, not null.
`totals[].amounts_by_period[].unit`# required	string\| null	Currency code inferred from the source context; null when undeterminable.
`totals[].amounts_by_period[].scale`# required	string\| null	'thousands', 'millions', 'billions', or null when absolute.
`totals[].amounts_by_period[].period`# required	object	Balance-sheet date for a disclosed debt amount.
`totals[].amounts_by_period[].period.type`# required	string	Always 'as_of'.
`totals[].amounts_by_period[].period.date`# required	string\| null	ISO 8601 date at the precision printed in the source; null when the source attaches no date.
`totals[].evidence`# required	object	Evidence object. Never null.
`totals[].evidence.quote`# required	string\| null	Verbatim excerpt from the filing proving this entry. Shortest contiguous source span; no ellipsis, no translation. null when there is no textual basis.
`totals[].evidence.reasoning`# required	string	How the source maps to this value. For null decisions, state the basis (not disclosed / not applicable / indeterminable / scope limitation).

Example dataset#

An illustrative example for debt_instruments. Use it to see the shape of the data before running a live request.

Top-level fields in the example dataset
Field	Summary
disclosure_status	disclosed
instruments	1 item
totals	1 item

Playground#

Response schema#

Fields 40

Field path	Type	Description
`disclosure_status`# required	object	Three-state debt disclosure status with evidence.
`disclosure_status.value`# required	string	'disclosed' = at least one issuer-owned debt instrument is disclosed. 'explicitly_none' = the filing explicitly states that no debt or borrowings are outstanding. 'not_disclosed' = no debt disclosure or explicit none-statement is found in scope.
`disclosure_status.evidence`# required	object	Evidence object. Never null.
`disclosure_status.evidence.quote`# required	string\| null	Verbatim excerpt from the filing proving this entry. Shortest contiguous source span; no ellipsis, no translation. null when there is no textual basis.
`disclosure_status.evidence.reasoning`# required	string	How the source maps to this value. For null decisions, state the basis (not disclosed / not applicable / indeterminable / scope limitation).
`instruments`# required	array\| null items: object	One entry per disclosed instrument; null for explicitly_none or not_disclosed.
`instruments[].name`# required	string\| null	Clean identifier without coupon rate or maturity; null for an unlabeled figure row.
`instruments[].category`# required	string	Coarse instrument type from the SEC authority schema.
`instruments[].seniority`# required	string\| null	Seniority only when stated; otherwise null.
`instruments[].secured`# required	string\| null	Security status only when stated; otherwise null.
`instruments[].classification`# required	string\| null	Balance-sheet classification when disclosed; otherwise null.
`instruments[].interest_rate`# required	object	One instrument's stated interest rate. Instrument-level evidence anchors this object.
`instruments[].interest_rate.value`# required	number\| null	Coupon or interest rate as written in percentage points (4.15 means 4.15%; 0 means 0%). For a variable rate, use the stated spread when it is a single number (1.25 for 'SOFR + 1.25%'); null when no rate figure is stated.
`instruments[].interest_rate.unit`# required	string\| null	'percent' when value is present; otherwise null.
`instruments[].interest_rate.rate_type`# required	string\| null	Fixed or variable when determinable from the filing; otherwise null.
`instruments[].interest_rate.basis`# required	string\| null	The rate as printed, verbatim, whenever `value` cannot carry it — a variable-rate basis ('SOFR plus 1.25%') or a fixed-rate range covering several tranches filed under one name ('3.46% - 4.73%'). null when a single figure already sits in `value`, or when the filing states no rate at all.
`instruments[].principal_by_period`# required	array items: object	Outstanding amount for every disclosed period, newest first and on one consistent basis.
`instruments[].principal_by_period[].value`# required	number\| null	Figure as written. A printed zero is 0, not null.
`instruments[].principal_by_period[].unit`# required	string\| null	Currency code inferred from the source context; null when undeterminable.
`instruments[].principal_by_period[].scale`# required	string\| null	'thousands', 'millions', 'billions', or null when absolute.
`instruments[].principal_by_period[].period`# required	object	Balance-sheet date for a disclosed debt amount.
`instruments[].principal_by_period[].period.type`# required	string	Always 'as_of'.
`instruments[].principal_by_period[].period.date`# required	string\| null	ISO 8601 date at the precision printed in the source; null when the source attaches no date.
`instruments[].maturity_date`# required	string\| null	Maturity date at the precision printed in the source; null when absent.
`instruments[].evidence`# required	object	Evidence object. Never null.
`instruments[].evidence.quote`# required	string\| null	Verbatim excerpt from the filing proving this entry. Shortest contiguous source span; no ellipsis, no translation. null when there is no textual basis.
`instruments[].evidence.reasoning`# required	string	How the source maps to this value. For null decisions, state the basis (not disclosed / not applicable / indeterminable / scope limitation).
`totals`# required	array\| null items: object	Printed debt subtotals or totals; null when none are printed.
`totals[].label`# required	string\| null	Printed subtotal label verbatim; null only for an unlabeled figure.
`totals[].classification`# required	string\| null	Classified subtotal, overall total, or null when not classifiable.
`totals[].amounts_by_period`# required	array items: object	Printed amount for every disclosed period, newest first.
`totals[].amounts_by_period[].value`# required	number\| null	Figure as written. A printed zero is 0, not null.
`totals[].amounts_by_period[].unit`# required	string\| null	Currency code inferred from the source context; null when undeterminable.
`totals[].amounts_by_period[].scale`# required	string\| null	'thousands', 'millions', 'billions', or null when absolute.
`totals[].amounts_by_period[].period`# required	object	Balance-sheet date for a disclosed debt amount.
`totals[].amounts_by_period[].period.type`# required	string	Always 'as_of'.
`totals[].amounts_by_period[].period.date`# required	string\| null	ISO 8601 date at the precision printed in the source; null when the source attaches no date.
`totals[].evidence`# required	object	Evidence object. Never null.
`totals[].evidence.quote`# required	string\| null	Verbatim excerpt from the filing proving this entry. Shortest contiguous source span; no ellipsis, no translation. null when there is no textual basis.
`totals[].evidence.reasoning`# required	string	How the source maps to this value. For null decisions, state the basis (not disclosed / not applicable / indeterminable / scope limitation).

Field

Summary

disclosure_status

disclosed

instruments

1 item

totals

1 item