US municipal bonds

This is the complete field dictionary for the data returned by the US municipal bond Reference Data endpoint. 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.

array of string

Financial advisors who provide advice on bond issuance and investment.

date

Date the bond was awarded to the underwriter in ISO-8601 format (YYYY-MM-DD).

string

Time the bond was awarded to the underwriter, in US Eastern Time, in ISO-8601 format (HH:MM:SS).

array of string

Legal representatives retained by the issuer that provide tax opinions, ensure compliance with federal tax law, and verify the legal validity of the bond issuance.

string

Indicates the capital purpose depending on whether the bond proceeds are used for new projects, to pay off prior bonds, or both.Allowed values: mixed, new money, refunding

date

Date the bond transaction closed in ISO-8601 format (YYYY-MM-DD).

string

Composite rating of the bond.

array of string

Counties of issuing entity, if applicable.

string

Country of issuing entity:

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

string

ISO 3166-1 alpha-2 country code (2-letter code) of the country of issue.

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.

array of string

Types of credit enhancement that provide additional security for the bond.Allowed values: appropriations_program, bond_insurance, capital_reserve_fund, debt_service_reserve_fund, federal_agency_guarantee, federal_guarantee, federal_mortgage_insurance, letter_of_credit, liquidity_facility, moral_obligation, pledged_assets, pledged_revenues, private_mortgage_insurance, state_aid_intercept_program, state_guarantee_program, state_mortgage_insurance, state_permanent_fund_program, surety_bond, third_party_guarantee

string

Currency in which the bond is denominated (3-letter ISO 4217 code).

date

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

array of string

Legal representatives retained by the issuer to provide advice on issuer disclosure obligations.

object

Extraordinary optional redemption terms and conditions.

Show properties

string

boolean

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 execution/trade for the bond in ISO-8601 format (YYYY-MM-DD).

string

Time of the first execution/trade for the bond, in US Eastern Time, in ISO-8601 format (HH:MM:SS).

date

Date of the first interest payment in ISO-8601 format (YYYY-MM-DD).

date

Date of the first trade in the secondary market in ISO-8601 format (YYYY-MM-DD).

string

Entity whose credit backstops return of prepayment proceeds on a prepaid gas or electricity municipal bond — the party obligated to return proceeds via scheduled payments or on early termination. null if not a prepaid energy structure.

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

boolean

Whether the bond has mandatory redemption features.

boolean

Whether the bond has an official statement published. Pre official statement bonds only have a limited set of fields available that are provided on a best-effort basis.

array of string

Financial institutions that issue an insurance policy for bonds, guaranteeing timely payment of principal and interest.

number

Integral multiple for bond denominations.

string

Day count convention for interest accrual:

30/360: 30 days per month, 360 days per year.
ACTUAL/ACTUAL: Uses actual number of days in period and year.
ACTUAL/360: Uses actual days in period, 360 days per year.
ACTUAL/365: Uses actual days in period, 365 days per year.
30/365: 30 days per month, 365 days per year.

date

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

number

Maximum interest rate for variable rate bonds; the highest rate the bond’s coupon can reach during its life, often set as a cap relative to the reference rate it is adjusted for.

number

Minimum interest rate for variable rate bonds; the lowest rate the bond’s coupon can fall to during its life, often set as a floor relative to the reference rate it is adjusted for.

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

The Type of interest:

fixed rate: The bond pays a fixed interest rate throughout its life.
cab: Capital Appreciation Bond (CAB), interest accrues and is paid at maturity rather than periodically.
variable rate: The bond’s interest rate can change over time, typically based on a reference rate or formula (e.g., SOFR, CPI).
term rate: The bond pays interest at a rate set for a specific term or period.
cab-to-fixed: The bond starts as a capital appreciation bond and converts to a fixed rate bond.
step rate: The bond’s interest rate increases (“steps up”) at predetermined intervals.
zero rate / discount rate: A bond that does not pay or accrue interest.

boolean

Whether the bond is Rule 144A compliant.

boolean

Whether the bond is an Alternative Minimum Tax (AMT) bond.

boolean

Whether the bond is a Build America Bond.

boolean

Whether the bond is bank qualified.

boolean

Whether the bond is callable before maturity.

boolean

Indicates whether the bond is backed by any form of credit enhancement.

boolean

Whether the bond is defeased.A defeased bond has funds set aside in an escrow account to pay off the remaining principal and interest, effectively removing the debt obligation from the issuer’s balance sheet.

boolean

Whether the bond is federally taxable.

boolean

Whether the bond is a green bond.

boolean

Whether the bond is insured by a bond insurance company.

boolean

Whether the bond is currently outstanding.

boolean

Whether the bond is a Planned Amortization Class (PAC) bond.

boolean

Whether the bond is Regulation S (RegS) compliant.

Whether the bond is a social bond.

boolean

Indicates whether the bond is backed by any form of state credit enhancement (state guarantee program, state aid intercept program, appropriations program or state permanent fund program).

boolean

Whether the bond is state taxable.

boolean

Whether the bond is a sustainable bond.

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.

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.

integer

The internal unique identifier of the issuer.

string

Name of the issuing entity (municipality, district, etc.).

string

Liquidity facility provider for the bond:

LOC: Letter of Credit
SBPA: Standby Bond Purchase Agreement
Self: Self-liquidity

array of object

The mandatory redemption schedule specifies the sinking fund redemptions, including the dates, amounts, and redemption prices based on principal or accreted value (for CABs).

[
  {
    "date": "<Date>",
    "price": {
      "type": "principal | accreted-value",
      "spread_in_bps": "<Number>"
    },
    "amount": "<Number>"
  },
  ...
]

number

Amount due at maturity:The principal amount that will be repaid when the bond matures.

date

Date when the bond principal is due to be repaid in ISO-8601 format (YYYY-MM-DD).

number

Minimum denomination in which the bond can be purchased.

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).

number

Indicates the nearest sinking fund amount, if exists.

date

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

number

Indicates the nearest sinking fund price, if exists.

string

The obligated entity, when it is not the same as the issuer

integer

The internal unique identifier of the obligor.

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.

integer

Maximum notice period for optional redemptions (in days).

integer

Minimum notice period for optional redemptions (in days).

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"
  },
  ...
]

number

Current outstanding amount of the bond.

string

ISIN of the parent bond, if this bond was created from a split or refunding.When bonds are split into multiple series or tranches, the parent_isin identifies the original bond from which this bond was derived.

date

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

date

Date when the provider’s commitment expires in ISO-8601 format (YYYY-MM-DD).

string

Name of the provider, typically for liquidity facilities or credit enhancements.

string

Credit rating group:

investment_grade: Bonds with high credit quality, typically considered safe and low risk.
high_yield: Bonds with lower credit quality, typically considered riskier and higher yield.

array of string

A municipal securities dealer responsible for reselling to investors securities (such as variable rate demand obligations and other tender option bonds) that have been tendered for purchase by their owner.

boolean

Indicates whether the bond is backed by a reserve fund (debt service reserve fund or capital reserve fund).

string

Indicates the method used by the issuer to sell the municipal bond to investors.Allowed values: competitive_sale, negotiated_sale, private_placement

string

Sector of the municipal bond:

education: Educational institutions (schools, universities, colleges).
local: Local government entities (cities, counties, towns).
utilities: Utility companies and infrastructure.
transportation: Transportation and transit systems.
state: State government entities.
healthcare: Healthcare facilities and medical institutions.
housing: Housing and residential development.
industrial: Industrial and economic development.
tobacco: Tobacco settlement bonds.

string

Seniority of the bond derived from the series name, ordered from most senior to most junior.It’s worth noting that senior is considered on par with first line, and subordinate is considered on par with junior.Allowed values: first_lien, junior, second_lien, senior, subordinate

string

Bond series name or description.

number

Amount issued in this specific series.

string

Source of repayment:

General Obligation: The bond is backed by the full faith and credit of the issuer.
Revenue: The bond is backed by the revenue generated from the project or service it funds.
Double Barrel: A combination of General Obligation and Revenue sources.

string

US state or territory where the bond is issued (ANSI 2-letter code).

array of string

Financial institutions that facilitate the tender of bonds to the issuer, typically in variable rate demand obligations or other bonds with put features.

array of object

The schedule of tender for a bond, including the tender date, tender type, tender period, tender price, and circumstance for tender

Show properties

string

Allowed values: credit or liquidity facility default, credit or liquidity facility expiration or substitution, extraordinary event, failed remarketing, in lieu of redemption, issuer or provider directed, optional tender, rate mode conversion, scheduled mandatory tender, unscheduled mandatory tender

object

Show properties

integer

string

Allowed values: day, month, week, year

date

object

Show properties

number

string

Allowed values: accreted-value, principal

string

Allowed values: mandatory, optional

string

Bond ticker symbol.

array of string

Financial institutions acting as intermediaries between bond issuers and bondholders, appointed by the issuer to represent bondholders’ interests and enforce the terms of the bond’s governing contract.

array of string

Financial institutions that facilitate the issuance and sale of bonds by purchasing them from the issuer and reselling them to investors.

object

The next anticipated corporate action event for the bond.

Show properties

date

string

Allowed values: bond_call, defeasance, redemption, refunding

array of string

Broad functional categories for bond proceeds (middle level).This is the middle level in the use of funds hierarchy: Use Sector > Use Category > Uses of ProceedsCategories group related uses of proceeds together. There are 31 categories across 10 sectors.For the complete taxonomy, see the Use of Funds Taxonomy reference page.Allowed values: airport, bridges, communication, culture, economic development, electrical, essential services, gas, gas prepay, general purpose, health system, higher education, hospitals, industrial development, military housing, miscellaneous, multi-family housing, parking, port, power, pre-school, primary and secondary education, public housing, public transit, recreational, roads, senior living, single family housing, student loan, waste removal, water and sewer

array of string

High-level sectors for bond proceeds (top level).This is the top level in the use of funds hierarchy: Use Sector > Use Category > Uses of ProceedsSectors are the broadest classification, grouping multiple categories. There are 10 sectors in total.For the complete taxonomy, see the Use of Funds Taxonomy reference page.Allowed values: development, education, government, healthcare, housing, miscellaneous, recreation, securitized, transportation, utility

array of string

Specific intended purposes for bond proceeds (most granular level).This is the most detailed level in the use of funds hierarchy: Use Sector > Use Category > Uses of ProceedsFor the complete taxonomy with all 90 uses of proceeds, see the Use of Funds Taxonomy reference page.Allowed values: airport, alternative source power, assisted living, broadband, buses, charter school, coal power, combined port authority, community centre, community college, continuing care retirement community, correctional facilities, courts, critical access hospital, development district, electrical infrastructure, ferries, fire, flood control, gas infrastructure, gas power, gas prepay, health system, hospitality, independent living, industrial development, irrigation, library, local hfa multi-family housing, local hfa single family housing, local standalone multi-family housing, local standalone single family housing, military housing, miscellaneous, museum, non-toll bridges, non-toll roads, nuclear power, nursing home, office buildings, parking facilities, parks, police, pollution control, pre-school and daycare, private college, public buildings, public college, public housing, public school district, regional toll bridges, regional toll roads, sewer, shopping centres, solar power, specialty hospital, stadium, standalone hospital, standalone port, standalone public school, state hfa multi-family housing, state hfa single family housing, state toll bridges, state toll roads, storm water, student housing, student loan, telephone, trains, tribal, waste removal, water, wind power

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

object

Schedule for when variable interest rates are adjusted.Specifies the frequency at which the bond’s variable interest rate is reset or recalculated based on a reference rate or index.

Show properties

integer

string

Allowed values: day, month, week

string

Variable rate mode for the bond, if applicable.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

Getting started

Data dictionaries

Other concepts

Government & corporate bonds

US agency bonds

Corporate bonds

US municipal bonds

US municipal bond statistics

Utilities

US municipal bonds