Reference Data

Authorizations

Authorization

string

header

required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Headers

enum<string>

default:application/json

required

Specify text/csv if you would like to receive a CSV file.

Available options:

application/json,

text/csv

Body

application/json

isins

string[]

required

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

Required string length: 12

Response

Reference data

data

object[]

required

List of response data objects, often capped to 1000.

Show child attributes

data.advisors

string[]

required

Financial advisors who provide advice on bond issuance and investment.

data.award_date

string<date> | null

required

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

data.bond_counsel

string[]

required

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.

data.capital_purpose

enum<string> | null

required

Indicates the capital purpose depending on whether the bond proceeds are used for new projects, to pay off prior bonds, or both.

Available options:

new money,

refunding,

mixed

data.closing_date

string<date>

required

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

data.composite_rating

string | null

required

Composite rating of the bond.

data.country

enum<string>

required

Country of issuing entity:

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

Available options:

United States of America

data.country_code

string

required

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

Required string length: 2

data.coupon_frequency

integer | null

required

Number of coupon payments per year.

Required range: x >= 0

data.coupon_payment_day

integer | null

required

Day of the month when coupon payments are made.

data.coupon_payment_months

(integer | null)[]

required

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

Examples:

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

Required range: 1 <= x <= 12

data.credit_enhancement_type

enum<string>[]

required

Types of credit enhancement that provide additional security for the bond.

Specifies the specific type of the credit enhancement. Set to [] if is_credit_enhanced is false

Available options:

bond_insurance,

letter_of_credit,

liquidity_facility,

state_aid_intercept_program,

state_guarantee_program,

appropriations_program,

state_permanent_fund_program,

federal_guarantee,

federal_agency_guarantee,

moral_obligation,

debt_service_reserve_fund,

capital_reserve_fund,

federal_mortgage_insurance,

private_mortgage_insurance,

state_mortgage_insurance,

pledged_revenues,

pledged_assets,

surety_bond,

third_party_guarantee

data.currency

string

required

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

Example:

"USD"

data.dated_date

string<date>

required

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

data.disclosure_counsel

string[]

required

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

data.extraordinary_optional_redemption

object[]

required

Extraordinary optional redemption terms and conditions.

data.figi

string | null

required

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

Required string length: 12

Example:

"BBG01L7LZSL5"

data.figi_name

string | null

required

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

data.first_call_date

string<date> | null

required

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

data.first_execution_date

string<date> | null

required

Date of the first execution/trade for the bond in ISO-8601 format (YYYY-MM-DD).

data.first_interest_payment_date

string<date>

required

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

data.first_trade_date

string<date> | null

required

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

data.guarantee

enum<string>

required

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.

Available options:

secured,

unsecured

data.has_mandatory_redemption

boolean

required

Whether the bond has mandatory redemption features.

data.insurers

string[]

required

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

data.integral_multiple

number

required

Integral multiple for bond denominations.

data.interest_accrual_convention

enum<string>

required

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.

Available options:

30/360,

30/365,

act/360,

act/365,

act/act,

act/act (AFB),

act/act (ISDA),

act/act (ICMA)

data.interest_accrual_date

string<date>

required

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

data.interest_maximum_rate

number | null

required

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.

data.interest_minimum_rate

number | null

required

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.

data.interest_payment_schedule

object[]

required

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:

[
  {
    "payment_date": "standard_date | weekday_date | business_day_date",
    "interest_type": "regular | accreting",
    "periodic_schedule": {
      "until": "<Date>",
      "period_type": "week | month",
      "period_amount": "<Number>"
    }
  },
  ...
]

where the schema for standard_date is:

  {
  "day": "<Integer>",
  "year": "<Integer>",
  "month": "<Integer>"
}

the schema for weekday_date is:

  {
  "year": "<Integer>",
  "month": "<Integer>",
  "day_of_week": "<Integer>",
  "week_of_month": "<Integer>"
}

and the schema for business_day_date is:

  {
  "business_day": "<Integer>",
  "year": "<Integer>",
  "month": "<Integer>"
}

data.interest_rate

required

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

data.interest_rate_schedule

object[]

required

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": "zero | fixed | variable | compounding",
    "interest_rate": {
    "benchmark": "sofr | libor | sifma | mmd | remarketing-agent", // applies only for variable rates; interest_rate would simply be a <Number> when the value is known
    "spread_bps": "<Number>" // applies only for variable rates; interest_rate would be a <Number> when the value is known
    },
    "determination_period": {
    "period_length": "<Integer>",
    "period_type": "day | week | month | year",
    },
    "rate_mode_name": "adjustable | pass-through | daily | two-day | weekly | bi-weekly | monthly | term | medium-term | long-term | term-floater | index | sifma | libor | sofr | auction | frn | window",
    "from_date": "<Date>",
    "until_date": "<Date>"
  },
  ...
]

data.interest_type

enum<string> | null

required

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 pay or accrue interest.

Available options:

fixed rate,

zero rate / discount rate,

cab,

cab-to-fixed,

at maturity,

variable rate,

step rate,

term rate,

cash payment,

payment in kind,

fixed interest payments,

dividend payments,

variable interest payments,

no payments,

misc.

data.is_144a

boolean

required

Whether the bond is Rule 144A compliant.

data.is_amt

boolean

required

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

data.is_bank_qualified

boolean

required

Whether the bond is bank qualified.

data.is_callable

boolean

required

Whether the bond is callable before maturity.

data.is_credit_enhanced

boolean

required

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

data.is_defeased

boolean | null

required

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.

data.is_federally_taxable

boolean

required

Whether the bond is federally taxable.

data.is_green

boolean

required

Whether the bond is a green bond.

data.is_insured

boolean | null

required

Whether the bond is insured by a bond insurance company.

data.is_outstanding

boolean

required

Whether the bond is currently outstanding.

data.is_pac

boolean

required

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

data.is_regs

boolean

required

Whether the bond is Regulation S (RegS) compliant.

Whether the bond is a social bond.

data.is_state_enhanced

boolean

required

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

data.is_state_taxable

boolean

required

Whether the bond is state taxable.

data.is_sustainable

boolean

required

Whether the bond is a sustainable bond.

data.isin

string

required

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

Required string length: 12

Example:

"US64966HW301"

data.issue_date

string<date>

required

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

data.issue_price

number | null

required

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

data.issue_yield

number | null

required

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

data.issued_amount

number

required

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

data.issuer_name

string

required

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

Example:

"SCHOOL DISTRICT NUMBER 172 ADAMS COUNTY, ILLINOIS (QUINCY)"

data.liquidity_facility

enum<string> | null

required

Liquidity facility provider for the bond:

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

Available options:

LOC,

SBPA,

Self

data.mandatory_redemption_schedule

object[]

required

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

data.maturity_amount

number | null

required

Amount due at maturity:

The principal amount that will be repaid when the bond matures.

data.maturity_date

string<date>

required

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

data.minimum_denomination

number

required

Minimum denomination in which the bond can be purchased.

data.next_call_date

string<date> | null

required

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

data.next_call_price

number | null

required

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

data.next_coupon_date

string<date> | null

required

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

data.next_sink_amount

number | null

required

Indicates the nearest sinking fund amount, if exists.

data.next_sink_date

string<date> | null

required

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

data.next_sink_price

number | null

required

Indicates the nearest sinking fund price, if exists.

data.obligor

string | null

required

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

data.odd_first_coupon

enum<string> | null

required

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.

Available options:

regular,

short,

long

data.odd_last_coupon

enum<string> | null

required

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.

Available options:

regular,

short,

long

data.optional_redemption_max_notice

integer | null

required

Maximum notice period for optional redemptions (in days).

data.optional_redemption_min_notice

integer | null

required

Minimum notice period for optional redemptions (in days).

data.optional_redemption_schedule

object[]

required

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

data.outstanding_amount

number | null

required

Current outstanding amount of the bond.

data.parent_isin

string | null

required

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.

Required string length: 12

Example:

"US64966HW302"

data.previous_coupon_date

string<date> | null

required

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

data.provider_expiration_date

string<date> | null

required

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

data.provider_identity

string | null

required

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

data.rating_group

enum<string> | null

required

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.

Available options:

investment_grade,

high_yield

data.remarketing_agents

string[]

required

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.

data.reserve_fund

boolean

required

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

data.sale_type

enum<string> | null

required

Indicates the method used by the issuer to sell the municipal bond to investors.

Available options:

competitive_sale,

negotiated_sale,

private_placement

data.sector

enum<string> | null

required

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.

Available options:

state,

local,

education,

healthcare,

housing,

utilities,

transportation,

industrial,

tobacco

data.series

string

required

Bond series name or description.

This is the name of the bond series, which is a unique identifier for the bond.

Example:

"SCHOOL DISTRICT NUMBER 172 ADAMS COUNTY, ILLINOIS (QUINCY) GENERAL OBLIGATION SCHOOL BONDS, SERIES 2024 (IL)"

data.series_issued_amount

number | null

required

Amount issued in this specific series.

data.source_of_repayment

enum<string> | null

required

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.

Available options:

Revenue,

General Obligation,

Double Barrel

data.state

string

required

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

Required string length: 2

Example:

"IL"

data.tender_agents

string[]

required

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

data.ticker

string | null

required

Bond ticker symbol.

Example:

"IL ADASCD 5 02/01/2035"

data.trustees

string[]

required

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.

data.underwriters

string[]

required

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

data.upcoming_corporate_action

object

required

The next anticipated corporate action event for the bond.

Show child attributes

data.upcoming_corporate_action.date

string<date>

data.upcoming_corporate_action.type

enum<string>

Available options:

redemption,

defeasance,

refunding,

bond_call

data.use_categories

enum<string>[] | null

required

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 Proceeds

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

Required array length: 1 - 5 elements

Available options:

general purpose,

essential services,

higher education,

primary and secondary education,

pre-school,

airport,

port,

public transit,

roads,

bridges,

parking,

economic development,

industrial development,

recreational,

culture,

health system,

hospitals,

senior living,

single family housing,

multi-family housing,

military housing,

public housing,

power,

water and sewer,

waste removal,

gas,

electrical,

communication,

gas prepay,

student loan,

miscellaneous

data.use_sectors

enum<string>[] | null

required

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 Proceeds

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

Minimum array length: 1

Available options:

government,

education,

transportation,

development,

recreation,

healthcare,

housing,

utility,

securitized,

miscellaneous

data.uses_of_proceeds

enum<string>[] | null

required

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 Proceeds

For the complete taxonomy with all 90 uses of proceeds, see the Use of Funds Taxonomy reference page.

Available options:

tribal,

police,

fire,

courts,

correctional facilities,

public college,

private college,

community college,

student housing,

charter school,

standalone public school,

public school district,

pre-school and daycare,

airport,

combined port authority,

standalone port,

trains,

buses,

ferries,

state toll roads,

regional toll roads,

non-toll roads,

state toll bridges,

regional toll bridges,

non-toll bridges,

parking facilities,

hospitality,

office buildings,

public buildings,

shopping centres,

development district,

industrial development,

pollution control,

stadium,

parks,

library,

museum,

community centre,

health system,

critical access hospital,

standalone hospital,

specialty hospital,

assisted living,

independent living,

continuing care retirement community,

nursing home,

state hfa single family housing,

local hfa single family housing,

local standalone single family housing,

state hfa multi-family housing,

local hfa multi-family housing,

local standalone multi-family housing,

military housing,

public housing,

nuclear power,

coal power,

gas power,

wind power,

solar power,

alternative source power,

water,

sewer,

storm water,

flood control,

irrigation,

waste removal,

gas infrastructure,

electrical infrastructure,

telephone,

broadband,

gas prepay,

student loan,

miscellaneous

data.variable_rate_adjustment_schedule

object

required

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 child attributes

data.variable_rate_adjustment_schedule.period_length

integer

Required range: x >= 1

data.variable_rate_adjustment_schedule.period_type

enum<string>

Available options:

day,

week,

month

data.variable_rate_mode

enum<string> | null

required

Variable rate mode for the bond, if applicable.

Available options:

adjustable,

pass-through,

daily,

two-day,

weekly,

bi-weekly,

monthly,

term,

short-term,

medium-term,

long-term,

term-floater,

floating,

index,

sifma,

libor,

sofr,

cpi,

auction,

frn,

window,

fixed,

flexible,

reset,

multiannual,

r-floats,

remarketing-agent,

permanent,

unit_price,

bank-purchase,

quarterly,

15-day

total

integer

required

Total number of results in the database that match the query filters.

Overview

Government and corporate bonds

US municipal bonds

Authorizations

Headers

Body

Response