Skip to main content
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.
​
isin
string
International Securities Identification Number (ISIN), unique 12-character code for the security.
​
advisors
array of string
Financial advisors who provide advice on bond issuance and investment.
​
award_date
date
Date the bond was awarded to the underwriter in ISO-8601 format (YYYY-MM-DD).
​
award_time
string
Time the bond was awarded to the underwriter, in US Eastern Time, in ISO-8601 format (HH:MM:SS).
​
bond_counsel
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.
​
capital_purpose
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
​
closing_date
date
Date the bond transaction closed in ISO-8601 format (YYYY-MM-DD).
​
composite_rating
string
Composite rating of the bond.
​
counties
array of string
Counties of issuing entity, if applicable.
​
country
string
Country of issuing entity:
  • United States of America: Country of issue is United States of America.
​
country_code
string
ISO 3166-1 alpha-2 country code (2-letter code) of the country of issue.
​
coupon_frequency
integer
Number of coupon payments per year.
​
coupon_payment_day
integer
Day of the month when coupon payments are made.
​
coupon_payment_months
array of integer
Months when coupon payments are made (1-12).Examples:
  • [2, 8]: Coupon payments are made on February and August.
​
credit_enhancement_type
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
​
currency
string
Currency in which the bond is denominated (3-letter ISO 4217 code).
​
dated_date
date
Date from which interest starts accruing in ISO-8601 format (YYYY-MM-DD).
​
disclosure_counsel
array of string
Legal representatives retained by the issuer to provide advice on issuer disclosure obligations.
​
extraordinary_optional_redemption
object
Extraordinary optional redemption terms and conditions.
​
figi
string
Financial Instrument Global Identifier (FIGI), a unique 12-character alphanumeric code for financial instruments.
​
figi_name
string
Name associated with the FIGI (Financial Instrument Global Identifier).
​
first_call_date
date
Date of the first call option in ISO-8601 format (YYYY-MM-DD).
​
first_execution_date
date
Date of the first execution/trade for the bond in ISO-8601 format (YYYY-MM-DD).
​
first_execution_time
string
Time of the first execution/trade for the bond, in US Eastern Time, in ISO-8601 format (HH:MM:SS).
​
first_interest_payment_date
date
Date of the first interest payment in ISO-8601 format (YYYY-MM-DD).
​
first_trade_date
date
Date of the first trade in the secondary market in ISO-8601 format (YYYY-MM-DD).
​
gas_prepay_guarantor
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.
​
guarantee
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
​
has_mandatory_redemption
boolean
Whether the bond has mandatory redemption features.
​
has_official_statement
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.
​
insurers
array of string
Financial institutions that issue an insurance policy for bonds, guaranteeing timely payment of principal and interest.
​
integral_multiple
number
Integral multiple for bond denominations.
​
interest_accrual_convention
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.
​
interest_accrual_date
date
Date in ISO-8601 format (YYYY-MM-DD) from which interest accrues.
​
interest_maximum_rate
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.
​
interest_minimum_rate
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.
​
interest_payment_schedule
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:
​
interest_rate
number or object
Interest rate or coupon of the bond, expressed as a percentage of the bond’s face value.
​
interest_rate_schedule
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:
​
interest_type
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.
​
is_144a
boolean
Whether the bond is Rule 144A compliant.
​
is_amt
boolean
Whether the bond is an Alternative Minimum Tax (AMT) bond.
​
is_bab
boolean
Whether the bond is a Build America Bond.
​
is_bank_qualified
boolean
Whether the bond is bank qualified.
​
is_callable
boolean
Whether the bond is callable before maturity.
​
is_credit_enhanced
boolean
Indicates whether the bond is backed by any form of credit enhancement.
​
is_defeased
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.
​
is_federally_taxable
boolean
Whether the bond is federally taxable.
​
is_green
boolean
Whether the bond is a green bond.
​
is_insured
boolean
Whether the bond is insured by a bond insurance company.
​
is_outstanding
boolean
Whether the bond is currently outstanding.
​
is_pac
boolean
Whether the bond is a Planned Amortization Class (PAC) bond.
​
is_regs
boolean
Whether the bond is Regulation S (RegS) compliant.
​
is_social
boolean
Whether the bond is a social bond.
​
is_state_enhanced
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).
​
is_state_taxable
boolean
Whether the bond is state taxable.
​
is_sustainable
boolean
Whether the bond is a sustainable bond.
​
issue_date
date
Date the bond was issued in ISO-8601 format (YYYY-MM-DD).
​
issue_price
number
Price at which the bond was issued (percentage of par), the price is expressed as a percentage of the bond’s face value.
​
issue_yield
number
Yield at issuance, the yield is expressed as a percentage of the bond’s face value.
​
issued_amount
number
Total amount issued (face value) in the bond’s currency.
​
issuer_canonical_id
integer
The internal unique identifier of the issuer.
​
issuer_name
string
Name of the issuing entity (municipality, district, etc.).
​
liquidity_facility
string
Liquidity facility provider for the bond:
  • LOC: Letter of Credit
  • SBPA: Standby Bond Purchase Agreement
  • Self: Self-liquidity
​
mandatory_redemption_schedule
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>"
  },
  ...
]
​
maturity_amount
number
Amount due at maturity:The principal amount that will be repaid when the bond matures.
​
maturity_date
date
Date when the bond principal is due to be repaid in ISO-8601 format (YYYY-MM-DD).
​
minimum_denomination
number
Minimum denomination in which the bond can be purchased.
​
next_call_date
date
Date of the next call option in ISO-8601 format (YYYY-MM-DD).
​
next_call_price
number
Price at the nearest call date from today, if exists.
​
next_coupon_date
date
Date of the next coupon payment in ISO-8601 format (YYYY-MM-DD).
​
next_sink_amount
number
Indicates the nearest sinking fund amount, if exists.
​
next_sink_date
date
Date of the next sinking fund payment in ISO-8601 format (YYYY-MM-DD).
​
next_sink_price
number
Indicates the nearest sinking fund price, if exists.
​
obligor
string
The obligated entity, when it is not the same as the issuer
​
obligor_canonical_id
integer
The internal unique identifier of the obligor.
​
odd_first_coupon
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.
​
odd_last_coupon
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.
​
optional_redemption_max_notice
integer
Maximum notice period for optional redemptions (in days).
​
optional_redemption_min_notice
integer
Minimum notice period for optional redemptions (in days).
​
optional_redemption_schedule
array of object
The optional redemption schedule defines the periods for which a bond is callable with a fixed, accreted value (for CABs) 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 | make-whole",
      "spread_in_bps": "<Number>", // spread above par for principal or accreted-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"
  },
  ...
]
​
outstanding_amount
number
Current outstanding amount of the bond.
​
parent_isin
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.
​
previous_coupon_date
date
Date of the previous coupon payment in ISO-8601 format (YYYY-MM-DD).
​
provider_expiration_date
date
Date when the provider’s commitment expires in ISO-8601 format (YYYY-MM-DD).
​
provider_identity
string
Name of the provider, typically for liquidity facilities or credit enhancements.
​
rating_group
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.
​
remarketing_agents
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.
​
reserve_fund
boolean
Indicates whether the bond is backed by a reserve fund (debt service reserve fund or capital reserve fund).
​
sale_type
string
Indicates the method used by the issuer to sell the municipal bond to investors.Allowed values: competitive_sale, negotiated_sale, private_placement
​
sector
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.
​
seniority
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
​
series
string
Bond series name or description.
​
series_issued_amount
number
Amount issued in this specific series.
​
source_of_repayment
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.
​
state
string
US state or territory where the bond is issued (ANSI 2-letter code).
​
tender_agents
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.
​
tender_schedule
array of object
The schedule of tender for a bond, including the tender date, tender type, tender period, tender price, and circumstance for tender
​
ticker
string
Bond ticker symbol.
​
trustees
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.
​
underwriters
array of string
Financial institutions that facilitate the issuance and sale of bonds by purchasing them from the issuer and reselling them to investors.
​
upcoming_corporate_action
object
The next anticipated corporate action event for the bond.
​
use_categories
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
​
use_sectors
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
​
uses_of_proceeds
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
​
validation_errors
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"]
  },
  ...
]
​
variable_rate_adjustment_schedule
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.
​
variable_rate_mode
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