Corporate bonds

This is the complete field dictionary for the data returned by the Corporate bond Reference Data endpoint.

This endpoint is in preview and not yet fully production-ready. Its fields, behavior, and availability may change without notice.

Each call returns an object of the shape { "data": [ ... ], "total": <integer> }, where every entry in data describes a single bond using the fields below.

string

International Securities Identification Number (ISIN), unique 12-character code for the security.

string

Alternative name(s) the bond is known by.

string

Classification of Financial Instruments (CFI) code:The CFI code is a six-letter code that classifies a financial instrument by its type and key features (e.g., fixed/floating rate, registered/bearer, secured/unsecured).

string

Composite rating of the issue.Allowed values: A, A+, A-, AA, AA+, AA-, AAA, B, B+, B-, BB, BB+, BB-, BBB, BBB+, BBB-, C, CC, CCC, CCC+, CCC-, D

string

Composite rating of the issuer.Allowed values: A, A+, A-, AA, AA+, AA-, AAA, B, B+, B-, BB, BB+, BB-, BBB, BBB+, BBB-, C, CC, CCC, CCC+, CCC-, D

string

Country of issuing entity:Examples:

Germany: Country of issue is Germany.
United Kingdom: Country of issue is United Kingdom.
United States of America: Country of issue is United States of America.

string

Country code of issuing entity (ISO 3166-1 alpha-2 country codes):

integer

Number of coupon payments per year.

integer

Day of the month when coupon payments are made.

array of integer

Months when coupon payments are made (1-12).Examples:

[2, 8]: Coupon payments are made on February and August.

string

Bond currency, 3-letter ISO 4217 code.

string

Financial Instrument Global Identifier (FIGI), a unique 12-character alphanumeric code for financial instruments.

string

Name associated with the FIGI (Financial Instrument Global Identifier).

date

Date of the first call option in ISO-8601 format (YYYY-MM-DD).

date

Date of the first interest payment in ISO-8601 format (YYYY-MM-DD).null when the bond pays no interest, such as a zero rate / discount bond (see interest_type), or when we have not established a payment schedule.

date

Date on which the bond transaction was executed between buyer and seller, as stated in the offering document (YYYY-MM-DD).

string

Indicates the security classification of the bond. Secured bonds are backed by specific collateral (pledged assets, revenues, or reserve funds), while unsecured bonds lack such backing.Allowed values: secured, unsecured

string

GICS industry group of the issuer.Follows sector: public for issuers GICS does not classify, null for a corporate issuer we have not classified yet.

number

Integral multiple for bond denominations.

string

Day count convention for interest accrual:

act/act (ICMA): Uses actual number of days in period and year.
30/360: Assumes 30 days per month, 360 days per year.
act/360: Uses actual days in period, 360 days per year.
act/365: Uses actual days in period, 365 days per year.
act/act: Uses actual number of days in period and year.
act/act (ISDA): ISDA convention for actual/actual.
act/act (AFB): AFB convention for actual/actual.

date

Date in ISO-8601 format (YYYY-MM-DD) from which interest accrues.

array of object

The interest payment schedule specifies the schedule of interest payments, which may be periodic or deferred until maturity (for CABs, notes or deferred interest bonds). It is represented as an array of objects with the following schema:

Show properties

string

Allowed values: accreting, regular

object

Show properties

integer

object

Show properties

integer

string

Allowed values: month, week

date

number or object

Interest rate or coupon of the bond, expressed as a percentage of the bond’s face value.

Show properties

string

number

array of object

The interest rate structure specifies the applicable interest rate for a given period and defines how it is set and adjusted over the bond’s term, including periodic adjustments for variable rate bonds. It is represented as an array of objects with the following schema:

Show properties

object

Show properties

integer

string

Allowed values: day, month, week

date

Can be null if it applies from issue

number or object

Show properties

string

Allowed values: auction, cpi, federal-funds-rate, libor, mmd, remarketing-agent, sifma, sofr, treasury

number

string

Allowed values: compounding, fixed, variable, zero

string

The name of the rate mode.Allowed values: 15-day, adjustable, auction, bank-purchase, bi-weekly, cpi, daily, fixed, flexible, floating, frn, index, libor, long-term, medium-term, monthly, multiannual, pass-through, permanent, quarterly, r-floats, remarketing-agent, reset, short-term, sifma, sofr, term, term-floater, two-day, unit_price, weekly, window

date

Can be null if it applies until maturity. Range is exclusive, i.e. means until but not including.

string

Type of interest:

fixed rate: The bond pays a fixed interest rate throughout its life.
zero rate / discount rate: A bond that does not pay or accrue interest.
variable rate: The bond’s interest rate can change over time, typically based on a reference rate or formula (e.g., SOFR, CPI).
step rate: The bond’s interest rate increases (“steps up”) at predetermined intervals.

boolean

Whether the bond is Rule 144A compliant,can be sold to qualified US institutional buyers.

boolean

Whether the bond is callable before maturity.

boolean

Whether the reference data for this bond is considered complete.

boolean

Whether the bond is a green bond.

boolean

Whether the bond is currently outstanding, has not matured, been called, or otherwise redeemed.

boolean

Whether the bond is puttable before maturity.

boolean

Whether the bond is Regulation S (RegS) compliant, can be sold to non-US investors.

date

Date the bond was issued in ISO-8601 format (YYYY-MM-DD).

number

Price at which the bond was issued (percentage of par), the price is expressed as a percentage of the bond’s face value.

string

Issue rating group, based on TP composite long-term ratings:

investment_grade: High credit quality (BBB- and above)
high_yield: Lower credit quality (BB+ and below)

number

Yield at issuance, the yield is expressed as a percentage of the bond’s face value.

number

Total amount issued (face value) in the bond’s currency.

string

Name of the issuing entity.

string

Issuer rating group, based on TP composite long-term ratings:

investment_grade: High credit quality (BBB- and above)
high_yield: Lower credit quality (BB+ and below)

string

Allowed values: corporate, government, government_linked, international_organization, municipal, state

string

Legal Entity Identifier (LEI) of the issuer:A 20-character, alpha-numeric code based on the ISO 17442 standard used to uniquely identify legal entities in financial transactions. Most LEIs follow this structure, but there are exceptions that use local national standards.

string

LEI of the direct parent of the issuer:A 20-character, alpha-numeric code based on the ISO 17442 standard used to uniquely identify legal entities in financial transactions. Most LEIs follow this structure, but there are exceptions that use local national standards.

string

LEI of the ultimate parent of the issuer:A 20-character, alpha-numeric code based on the ISO 17442 standard used to uniquely identify legal entities in financial transactions. Most LEIs follow this structure, but there are exceptions that use local national standards.

object

Long-term credit ratings of the issue, keyed by rating agency.

object

Long-term credit ratings of the issuer, keyed by rating agency.

date

Date when the bond principal is due to be repaid in ISO-8601 format (YYYY-MM-DD).null when the bond has no maturity date, such as a perpetual (see maturity_type), or when we have not established one.

string

Maturity type:

fixed: Principal repaid at maturity.
amortized: Principal repaid gradually before maturity.
perpetual: No maturity date; principal is never repaid.
extendible: Maturity date can be extended by issuer or holder.

number

Minimum denomination in which the bond can be purchased.

string

Full name of the bond.

date

Date of the next call option in ISO-8601 format (YYYY-MM-DD).

number

Price at the nearest call date from today, if exists.

date

Date of the next coupon payment in ISO-8601 format (YYYY-MM-DD).

string

Indicates whether the first coupon payment is odd:

regular: First coupon payment follows the standard interval.
short: First coupon period is shorter than the typical payment interval.
long: First coupon period is longer than the typical payment interval.

string

Indicates whether the last coupon payment is odd:

regular: Last coupon payment follows the standard interval.
short: Last coupon period is shorter than the typical payment interval.
long: Last coupon period is longer than the typical payment interval.

array of object

The optional redemption schedule defines the periods for which a bond is callable with a fixed, accreted value (for CABs), amortized value, and make-whole price. It is represented as an array of objects with the following schema:

[
  {
    "until": "<Date>",
    "call_date": "<Date>",
    "call_price": {
      "type": "principal | accreted-value | amortized-value | make-whole",
      "spread_in_bps": "<Number>", // spread above par for principal, accreted-value, or amortized-value; spread above benchmark for make-whole
      "benchmark": "mmd | treasury" // benchmark only applies when it's make-whole
    },
    "is_periodic": "true | false",
    "period_type": "day | month",
    "period_amount": "<number>",  // period_amount=1 and period_type="day" means continuously callable
    "includes_accrued_interest": "true | false"
  },
  ...
]

date

Date of the previous coupon payment in ISO-8601 format (YYYY-MM-DD).

string

Registration type:

bearer: Ownership is determined by physical possession.
registered: Ownership is recorded and tracked by issuer or agent.
misc.: Miscellaneous registration types.
bearer / registered: Hybrid registration type.

string

GICS sector of the issuer.public is returned for issuers that GICS does not classify — governments, states, municipalities and supranationals (see issuer_type). A corporate issuer we have not classified yet returns null.Allowed values: communication services, consumer discretionary, consumer staples, education, energy, financials, health care, industrials, information technology, materials, public, real estate, utilities

string

Type of debt instrument, e.g. bond, note, or commercial paper.Allowed values: asset_backed_security, bond, bond_with_warrants_attached, convertible_note, depository_receipt_on_debt_instruments, depository_shares, medium_term_note, money_market, mortgage_backed_security, preferred_stock, structured_product

string

Seniority of the bond:

senior: Senior debt.
senior_subordinate: Senior within the subordinate class.
subordinate: Subordinate debt.
junior_subordinate: Junior within the subordinate class.
junior: Junior debt.
mezzanine: Mezzanine debt.

object

Short-term credit ratings of the issue, keyed by rating agency.

object

Short-term credit ratings of the issuer, keyed by rating agency.

string

Bond ticker symbol.

array of object

A list of known data issues for the bond where validation rules have failed.

[
  {
    "details": "null_coupon_frequency",
    "field_names": ["coupon_frequency"]
  },
  ...
]

Show properties

string

array of string

Getting started

Data dictionaries

Other concepts

Government & corporate bonds

US agency bonds

US municipal bonds

US municipal bond statistics

Utilities

Corporate bonds