Skip to main content
POST
US municipal bond search

Authorizations

Authorization
string
header
required

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

Body

application/json
advisors
string[]

Optional filter to return only bonds with a specific advisor.

coupon_max
number

Maximum interest rate of the municipal bond (in percentage). Only matches bonds with a fixed, numeric interest rate.

coupon_min
number

Minimum interest rate of the municipal bond (in percentage). Only matches bonds with a fixed, numeric interest rate.

cursor
string | null

The next_cursor of the previous page. Leave out, or send null, for the first page. Only cursor and limit may change between pages. See Pagination.

entity_id
integer

The ID of the issuer or obligor to filter by.

full_reference_data
boolean

Return full reference data as in from /api/v1/muni_reference. This option requires a special account tier.

include_bonds_without_os
boolean
default:false

Whether to include municipal bonds for which a final official statement is not found or is not yet available. This will most often correspond to recently issued bonds.

The fields in these bonds are provided on a best-effort basis from the limited information available at that stage.

include_callable
boolean

Whether to include callable municipal bonds, bonds that can be redeemed before maturity.

interest_types
enum<string>[]

Types 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.
  • fixed to float: The bond pays a fixed coupon for an initial period, then floats with a reference rate.
  • float to fixed: The bond pays a floating coupon for an initial period, then converts to a fixed rate.
  • 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.
Available options:
cab,
cab-to-fixed,
fixed rate,
fixed to float,
float to fixed,
step rate,
term rate,
variable rate,
zero rate / discount rate
is_insured
boolean | null

Whether the bond is insured by a bond insurance company.

isins
string[]

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

Required string length: 12
issue_date_max
string<date>

Maximum issue date of the municipal bond in ISO-8601 format (YYYY-MM-DD).

issue_date_min
string<date>

Minimum issue date of the municipal bond in ISO-8601 format (YYYY-MM-DD).

issued_amount_max
integer

Maximum size of total amount issued (in nominal value).

Required range: x >= 0
issued_amount_min
integer

Minimum size of total amount issued (in nominal value).

Required range: x >= 0
issuer_name
string

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

last_traded_since
string<date>

Optional date filter to only return bonds that have been traded since the specified UTC date in ISO-8601 format (YYYY-MM-DD).

limit
integer
default:100

Number of results per page. A limit of 0 returns only total, the number of matching results.

Required range: x >= 0
maturity_date_max
string<date>

Maximum maturity date of the municipal bond in ISO-8601 format (YYYY-MM-DD).

maturity_date_min
string<date>

Minimum maturity date of the municipal bond in ISO-8601 format (YYYY-MM-DD).

offset
integer
deprecated

Deprecated, will be removed on April 2, 2027. Use cursor instead, see Pagination. Number of results to skip. Can't be combined with cursor unless 0.

Required range: x >= 0
sectors
enum<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.
Available options:
education,
healthcare,
housing,
industrial,
local,
state,
tobacco,
transportation,
utilities
sort
enum<string>[]

Fields to sort by. Prefix a field with '-' for descending order. Results with no value come last. See Order for how ties are broken.

Available options:
-has_official_statement,
-interest_rate,
-interest_type,
-is_callable,
-isin,
-issue_date,
-issuer_name,
-maturity_date,
-rating_group,
-state,
-ticker,
has_official_statement,
interest_rate,
interest_type,
is_callable,
isin,
issue_date,
issuer_name,
maturity_date,
rating_group,
state,
ticker
sources_of_repayment
enum<string>[]

Sources of repayment for municipal bonds. Determines how the bond will be repaid.

  • Revenue: Repaid from specific project revenues (e.g., tolls, utilities).
  • General Obligation: Repaid from the issuer's general fund.
  • Double Barrel: A combination of General Obligation and Revenue sources.
Available options:
Double Barrel,
General Obligation,
Revenue
states
string[]

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

Required string length: 2
underwriters
string[]

Optional filter to return only bonds issued through a specific underwriter.

use_categories
enum<string>[]

Filter bonds by use categories (middle level of use of funds hierarchy).

For the complete taxonomy, see the Use of Funds Taxonomy reference page.

Available options:
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
enum<string>[]

Filter bonds by use sectors (top level of use of funds hierarchy).

For the complete taxonomy, see the Use of Funds Taxonomy reference page.

Available options:
development,
education,
government,
healthcare,
housing,
miscellaneous,
recreation,
securitized,
transportation,
utility
uses_of_proceeds
enum<string>[]

Filter bonds by uses of proceeds (most granular level of use of funds hierarchy).

For the complete taxonomy, see the Use of Funds Taxonomy reference page.

Available options:
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
values_updated_since

Optional filter to only return bonds whose reference data has been updated since the given UTC instant.

Accepts an ISO-8601 date-time (YYYY-MM-DDThh:mm:ssZ), which is recommended since reference data can be updated multiple times per day.

A plain ISO-8601 date (YYYY-MM-DD) is also accepted for backwards compatibility but is deprecated, as it only resolves to the start of that day (00:00:00 UTC).

Response

Partial reference data

data
object[]
required

List of response data objects, often capped to 1000.

next_cursor
string | null
required

Send as cursor to get the next page. null on the last page, or when limit is 0.

total
integer
required

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