{
"errors": [
{
"detail": "Unauthorized",
"reason": "Your account tier does not allow this operation. Contact team@terrapinfinance.com for an upgrade."
}
]
}
{
"errors": [
{
"detail": "Payment Required",
"reason": "You have run out of your granted quota for this resource as defined by your account tier. Contact team@terrapinfinance.com for an upgrade."
}
]
}
{
"errors": [
{
"detail": "Forbidden",
"reason": "Your account tier does not allow this operation. Contact team@terrapinfinance.com for an upgrade."
}
]
}
{
"errors": [
{
"detail": "Unauthorized",
"reason": "Your account tier does not allow this operation. Contact team@terrapinfinance.com for an upgrade."
}
]
}
{
"errors": [
{
"detail": "Payment Required",
"reason": "You have run out of your granted quota for this resource as defined by your account tier. Contact team@terrapinfinance.com for an upgrade."
}
]
}
{
"errors": [
{
"detail": "Forbidden",
"reason": "Your account tier does not allow this operation. Contact team@terrapinfinance.com for an upgrade."
}
]
}
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, at most your tier's response size limit. 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.
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
One page of at most limit results. See Pagination.
Show child attributes
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.
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Terrapin","colors":{"primary":"#5cc9c4","light":"#78d9d4","dark":"#3a9e99"},"logo":{"light":"https://mintcdn.com/terrapinfinance/izOIwTIm47tha4Ui/logo.png?fit=max\u0026auto=format\u0026n=izOIwTIm47tha4Ui\u0026q=85\u0026s=259202f1a61642e74e1194ad39a9e024","dark":"https://mintcdn.com/terrapinfinance/izOIwTIm47tha4Ui/logo.png?fit=max\u0026auto=format\u0026n=izOIwTIm47tha4Ui\u0026q=85\u0026s=259202f1a61642e74e1194ad39a9e024","href":"https://terrapinfinance.com"},"favicon":"https://mintcdn.com/terrapinfinance/izOIwTIm47tha4Ui/favicon-32x32.png?fit=max\u0026auto=format\u0026n=izOIwTIm47tha4Ui\u0026q=85\u0026s=58578f8d2047f9bcac70a1a5bcff33d4","appearance":{"default":"dark","strict":true},"background":{"color":{"light":"#f2f1ec","dark":"#101210"}},"navbar":{"links":[{"href":"https://calendly.com/miguel-terrapinfinance/terrapin-fixed-income-data","label":"Book a demo"}],"primary":{"type":"button","label":"Get API key","href":"https://terrapinfinance.com/app"}},"footer":{"socials":{"linkedin":"https://www.linkedin.com/company/terrapin-finance"}},"seo":{"metatags":{"og:image":"https://terrapinfinance.com/images/og/documentation.png","twitter:image":"https://terrapinfinance.com/images/og/documentation.png"}},"styling":{"codeblocks":{"theme":{"light":"catppuccin-latte","dark":"github-dark-high-contrast"}},"latex":true},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"terrapinfinance","hasAudioNarration":false,"actualSubdomain":"terrapinfinance","customDomains":["docs.terrapinfinance.com"],"gitSource":{"type":"github","owner":"terrapin-code","repo":"terrapin-app","deployBranch":"main","contentDirectory":"api-docs","isPrivate":true,"mountPath":"","label":""},"entitlements":{},"buildId":"6af3661077bbd85befb3ab16","clientVersion":"0.0.4142","searchFilterCounts":[{"language":"default","tag":"API Reference","count":45},{"language":"default","tag":"Credit Intel Platform","count":13},{"language":"default","tag":"US municipal securities","count":11},{"language":"default","tag":"Government \u0026 corporate bonds (deprecated)","count":5},{"language":"default","tag":"Fixed income securities","count":5},{"language":"default","tag":"US agency bonds (deprecated)","count":5},{"language":"default","tag":"Getting started","count":5},{"language":"default","tag":"Coverage","count":5},{"language":"default","tag":"US municipal bond statistics","count":4},{"language":"default","tag":"Data dictionaries","count":4}]},"assistantConfig":{},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-rbac-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-metadata","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"live-agents","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[],"page":{"pagePath":"api-endpoints/us-municipal-bond-search","slug":"/api-endpoints/us-municipal-bond-search","pageMetadata":{"title":"Bond Search","openapi":"post /api/v1/muni_search","description":"This endpoint returns a list of US municipal bonds with a small set of fields. It is intended for search according to the filters provided.","href":"/api-endpoints/us-municipal-bond-search"},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsx(_components.p, {\n children: \"This endpoint returns a list of US municipal bonds with a small set of fields. It is intended for search according to the filters provided.\"\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){return _jsx(_Fragment,{})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent}","frontmatter":{},"scope":{"codeStyling":{"theme":{"light":"catppuccin-latte","dark":"github-dark-high-contrast"}},"config":{},"pageMetadata":{"title":"Bond Search","openapi":"post /api/v1/muni_search","description":"This endpoint returns a list of US municipal bonds with a small set of fields. It is intended for search according to the filters provided.","href":"/api-endpoints/us-municipal-bond-search"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"callbacks":{},"description":"This endpoint returns a list of US municipal bonds with a small set of fields. It is intended for search according to the filters provided.","operationId":"post_muni_search","parameters":[],"requestBody":"d2a224ff-ea0d-4a11-836f-9305a0d17288","responses":{"200":"e7fcdb4f-3e5e-4826-a8d5-940f7ed937f5","401":"72e1c4ad-bbf5-4b59-859f-6ba1b1a73177","402":"ff59749d-73b7-4c95-93ad-eb7000fa19cc","403":"54ddeaf9-d197-45ff-b7fd-75def98b0d79","422":"e4102e49-2d12-47fb-9292-db069564f708","429":"ef9f38e2-e959-440d-babc-f3c6f419f251","500":"1a3d1c8e-f195-4e3f-b3cb-c069401f67d2"},"summary":"US municipal bond search","tags":[],"method":"post","type":"path","servers":["4da2332b-a441-44a2-a604-2a3adeef8694"],"security":["142f149d-09d5-4d79-a55f-9635b5ba8d6a"],"path":"/api/v1/muni_search","baseUrlOptions":["https://terrapinfinance.com"],"title":"US municipal bond search","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{},"requestBody":{"content":{"application/json":{"example":{"interest_types":["variable rate"],"issuer_name":"ABAG Finance Authority for Nonprofit Corporations","maturity_date_min":"2030-10-30"},"schema":{"additionalProperties":false,"properties":{"advisors":{"description":"Optional filter to return only bonds with a specific advisor.\n","items":{"type":"string","uniqueKey":"advisors.items.[INDEX]","typeLabel":"string"},"nullable":false,"type":"array","uniqueKey":"advisors","typeLabel":"string[]"},"coupon_max":{"description":"Maximum interest rate of the municipal bond (in percentage). Only matches bonds with a fixed, numeric interest rate.","type":"number","uniqueKey":"coupon_max","typeLabel":"number"},"coupon_min":{"description":"Minimum interest rate of the municipal bond (in percentage). Only matches bonds with a fixed, numeric interest rate.","type":"number","uniqueKey":"coupon_min","typeLabel":"number"},"cursor":{"oneOf":[{"description":"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](https://docs.terrapinfinance.com/pagination).","type":"string","uniqueKey":"cursor.oneOf.0","typeLabel":"string"},{"description":"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](https://docs.terrapinfinance.com/pagination).","type":"null","uniqueKey":"cursor.oneOf.1","typeLabel":"null"}],"uniqueKey":"cursor","typeLabel":"string | null"},"entity_id":{"description":"The ID of the issuer or obligor to filter by.","type":"integer","uniqueKey":"entity_id","typeLabel":"integer"},"full_reference_data":{"description":"Return full reference data as in from /api/v1/muni_reference. This option requires a special account tier.","type":"boolean","uniqueKey":"full_reference_data","typeLabel":"boolean"},"include_bonds_without_os":{"default":false,"description":"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.\n\nThe fields in these bonds are provided on a best-effort basis from the limited information available at that stage.\n","type":"boolean","uniqueKey":"include_bonds_without_os","typeLabel":"boolean"},"include_callable":{"description":"Whether to include callable municipal bonds, bonds that can be redeemed before maturity.\n","type":"boolean","uniqueKey":"include_callable","typeLabel":"boolean"},"interest_types":{"description":"Types of interest:\n\n- `fixed rate`: The bond pays a fixed interest rate throughout its life.\n- `cab`: Capital Appreciation Bond (CAB), interest accrues and is paid at maturity rather than periodically.\n- `variable rate`: The bond's interest rate can change over time, typically based on a reference rate or formula (e.g., SOFR, CPI).\n- `term rate`: The bond pays interest at a rate set for a specific term or period.\n- `fixed to float`: The bond pays a fixed coupon for an initial period, then floats with a reference rate.\n- `float to fixed`: The bond pays a floating coupon for an initial period, then converts to a fixed rate.\n- `cab-to-fixed`: The bond starts as a capital appreciation bond and converts to a fixed rate bond.\n- `step rate`: The bond's interest rate increases (\"steps up\") at predetermined intervals.\n- `zero rate / discount rate`: A bond that does not pay or accrue interest.\n","items":{"enum":["cab","cab-to-fixed","fixed rate","fixed to float","float to fixed","step rate","term rate","variable rate","zero rate / discount rate"],"nullable":false,"type":"string","uniqueKey":"interest_types.items.[INDEX]","typeLabel":"enum\u003cstring>"},"type":"array","x-transform":"downcase","uniqueKey":"interest_types","typeLabel":"enum\u003cstring>[]"},"is_insured":{"oneOf":[{"description":"Whether the bond is insured by a bond insurance company.\n","type":"boolean","uniqueKey":"is_insured.oneOf.0","typeLabel":"boolean"},{"description":"Whether the bond is insured by a bond insurance company.\n","type":"null","uniqueKey":"is_insured.oneOf.1","typeLabel":"null"}],"uniqueKey":"is_insured","typeLabel":"boolean | null"},"isins":{"description":"International Securities Identification Number (ISIN), unique 12-character code for the security.","items":{"example":"US64966HW301","maxLength":12,"minLength":12,"nullable":false,"type":"string","uniqueKey":"isins.items.[INDEX]","typeLabel":"string"},"type":"array","x-check":"valid_check_digit","x-check-error":"Invalid ISIN check digit","x-transform":"upcase","uniqueKey":"isins","typeLabel":"string[]"},"issue_date_max":{"description":"Maximum issue date of the municipal bond in ISO-8601 format (YYYY-MM-DD).","format":"date","type":"string","uniqueKey":"issue_date_max","typeLabel":"string\u003cdate>"},"issue_date_min":{"description":"Minimum issue date of the municipal bond in ISO-8601 format (YYYY-MM-DD).","format":"date","type":"string","uniqueKey":"issue_date_min","typeLabel":"string\u003cdate>"},"issued_amount_max":{"description":"Maximum size of total amount issued (in nominal value).","minimum":0,"type":"integer","uniqueKey":"issued_amount_max","typeLabel":"integer"},"issued_amount_min":{"description":"Minimum size of total amount issued (in nominal value).","minimum":0,"type":"integer","uniqueKey":"issued_amount_min","typeLabel":"integer"},"issuer_name":{"description":"Name of the issuing entity (municipality, district, etc.).","nullable":false,"type":"string","uniqueKey":"issuer_name","typeLabel":"string"},"last_traded_since":{"description":"Optional date filter to only return bonds that have been traded since the specified UTC date in ISO-8601 format (YYYY-MM-DD).\n","format":"date","nullable":false,"type":"string","uniqueKey":"last_traded_since","typeLabel":"string\u003cdate>"},"limit":{"default":100,"description":"Number of results per page, at most your tier's [response size limit](https://docs.terrapinfinance.com/rate-limits-and-quotas#response-size-limits). A limit of 0 returns only `total`, the number of matching results.","minimum":0,"type":"integer","uniqueKey":"limit","typeLabel":"integer"},"maturity_date_max":{"description":"Maximum maturity date of the municipal bond in ISO-8601 format (YYYY-MM-DD).","format":"date","type":"string","uniqueKey":"maturity_date_max","typeLabel":"string\u003cdate>"},"maturity_date_min":{"description":"Minimum maturity date of the municipal bond in ISO-8601 format (YYYY-MM-DD).","format":"date","type":"string","uniqueKey":"maturity_date_min","typeLabel":"string\u003cdate>"},"offset":{"deprecated":true,"description":"**Deprecated**, will be removed on April 2, 2027. Use `cursor` instead, see [Pagination](https://docs.terrapinfinance.com/pagination). Number of results to skip. Can't be combined with `cursor` unless 0.","minimum":0,"type":"integer","uniqueKey":"offset","typeLabel":"integer"},"sectors":{"description":" Sector of the municipal bond:\n\n - `education`: Educational institutions (schools, universities, colleges).\n - `local`: Local government entities (cities, counties, towns).\n - `utilities`: Utility companies and infrastructure.\n - `transportation`: Transportation and transit systems.\n - `state`: State government entities.\n - `healthcare`: Healthcare facilities and medical institutions.\n - `housing`: Housing and residential development.\n - `industrial`: Industrial and economic development.\n - `tobacco`: Tobacco settlement bonds.\n","items":{"enum":["education","healthcare","housing","industrial","local","state","tobacco","transportation","utilities"],"nullable":false,"type":"string","uniqueKey":"sectors.items.[INDEX]","typeLabel":"enum\u003cstring>"},"type":"array","x-transform":"downcase","uniqueKey":"sectors","typeLabel":"enum\u003cstring>[]"},"sort":{"description":"Fields to sort by. Prefix a field with '-' for descending order. Results with no value come last. See [Order](https://docs.terrapinfinance.com/pagination#order) for how ties are broken.","items":{"enum":["-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"],"type":"string","uniqueKey":"sort.items.[INDEX]","typeLabel":"enum\u003cstring>"},"type":"array","x-transform":"downcase","uniqueKey":"sort","typeLabel":"enum\u003cstring>[]"},"sources_of_repayment":{"description":"Sources of repayment for municipal bonds. Determines how the bond will be repaid.\n\n- `Revenue`: Repaid from specific project revenues (e.g., tolls, utilities).\n- `General Obligation`: Repaid from the issuer's general fund.\n- `Double Barrel`: A combination of General Obligation and Revenue sources.\n","items":{"enum":["Double Barrel","General Obligation","Revenue"],"nullable":false,"type":"string","uniqueKey":"sources_of_repayment.items.[INDEX]","typeLabel":"enum\u003cstring>"},"type":"array","uniqueKey":"sources_of_repayment","typeLabel":"enum\u003cstring>[]"},"states":{"description":"US states or territory where the bond is issued (ANSI 2-letter code).\n","items":{"example":"IL","maxLength":2,"minLength":2,"nullable":false,"type":"string","uniqueKey":"states.items.[INDEX]","typeLabel":"string"},"type":"array","x-transform":"upcase","uniqueKey":"states","typeLabel":"string[]"},"underwriters":{"description":"Optional filter to return only bonds issued through a specific underwriter.\n","items":{"type":"string","uniqueKey":"underwriters.items.[INDEX]","typeLabel":"string"},"nullable":false,"type":"array","uniqueKey":"underwriters","typeLabel":"string[]"},"use_categories":{"description":"Filter bonds by use categories (middle level of use of funds hierarchy).\n\nFor the complete taxonomy, see the [Use of Funds Taxonomy](https://docs.terrapinfinance.com/use_of_funds_taxonomy) reference page.\n","items":{"enum":["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"],"nullable":false,"type":"string","uniqueKey":"use_categories.items.[INDEX]","typeLabel":"enum\u003cstring>"},"type":"array","x-transform":"downcase","uniqueKey":"use_categories","typeLabel":"enum\u003cstring>[]"},"use_sectors":{"description":"Filter bonds by use sectors (top level of use of funds hierarchy).\n\nFor the complete taxonomy, see the [Use of Funds Taxonomy](https://docs.terrapinfinance.com/use_of_funds_taxonomy) reference page.\n","items":{"enum":["development","education","government","healthcare","housing","miscellaneous","recreation","securitized","transportation","utility"],"nullable":false,"type":"string","uniqueKey":"use_sectors.items.[INDEX]","typeLabel":"enum\u003cstring>"},"type":"array","x-transform":"downcase","uniqueKey":"use_sectors","typeLabel":"enum\u003cstring>[]"},"uses_of_proceeds":{"description":"Filter bonds by uses of proceeds (most granular level of use of funds hierarchy).\n\nFor the complete taxonomy, see the [Use of Funds Taxonomy](https://docs.terrapinfinance.com/use_of_funds_taxonomy) reference page.\n","items":{"enum":["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"],"nullable":false,"type":"string","uniqueKey":"uses_of_proceeds.items.[INDEX]","typeLabel":"enum\u003cstring>"},"type":"array","x-transform":"downcase","uniqueKey":"uses_of_proceeds","typeLabel":"enum\u003cstring>[]"},"values_updated_since":{"oneOf":[{"type":"string","description":"Optional filter to only return bonds whose reference data has been updated since the given UTC instant.\n\nAccepts an ISO-8601 date-time (YYYY-MM-DDThh:mm:ssZ), which is recommended since reference data can be updated multiple times per day.\n\nA 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).\n","format":"date-time","uniqueKey":"values_updated_since.oneOf.0","typeLabel":"string\u003cdate-time>"},{"type":"string","description":"Optional filter to only return bonds whose reference data has been updated since the given UTC instant.\n\nAccepts an ISO-8601 date-time (YYYY-MM-DDThh:mm:ssZ), which is recommended since reference data can be updated multiple times per day.\n\nA 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).\n","format":"date","deprecated":true,"uniqueKey":"values_updated_since.oneOf.1","typeLabel":"string\u003cdate>"}],"uniqueKey":"values_updated_since","typeLabel":"string\u003cdate-time> | string\u003cdate>"}},"type":"object","uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"interest_types":["variable rate"],"issuer_name":"ABAG Finance Authority for Nonprofit Corporations","maturity_date_min":"2030-10-30"}}},"exampleType":"examples"}},"required":true,"exampleType":"examples"},"responses":{"e7fcdb4f-3e5e-4826-a8d5-940f7ed937f5":{"content":{"application/json":{"example":{"data":[{"has_official_statement":true,"interest_rate":5,"interest_type":"fixed rate","is_callable":true,"isin":"US00037CUQ13","issuer_name":"ABAG Finance Authority for Nonprofit Corporations","maturity_date":"2035-11-15","rating_group":"investment_grade","state":"CA","ticker":"CA AFAGEN 5 11/15/2035"}],"next_cursor":null,"total":1},"schema":{"additionalProperties":false,"properties":{"data":{"description":"One page of at most `limit` results. See [Pagination](https://docs.terrapinfinance.com/pagination).","items":{"additionalProperties":false,"properties":{"has_official_statement":{"description":"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.\n","nullable":false,"type":"boolean","isRequired":true,"uniqueKey":"data.items.[INDEX].has_official_statement","typeLabel":"boolean"},"interest_rate":{"oneOf":[{"type":"number","description":"Interest rate or coupon of the bond, expressed as a percentage of the bond's face value.\n","isRequired":true,"uniqueKey":"data.items.[INDEX].interest_rate.oneOf.0","typeLabel":"number"},{"type":"null","description":"Interest rate or coupon of the bond, expressed as a percentage of the bond's face value.\n","isRequired":true,"uniqueKey":"data.items.[INDEX].interest_rate.oneOf.1","typeLabel":"null"},{"type":"object","description":"Interest rate or coupon of the bond, expressed as a percentage of the bond's face value.\n","properties":{"benchmark":{"type":"string","uniqueKey":"data.items.[INDEX].interest_rate.oneOf.2.benchmark","typeLabel":"string"},"pct_of_benchmark":{"oneOf":[{"type":"number","uniqueKey":"data.items.[INDEX].interest_rate.oneOf.2.pct_of_benchmark.oneOf.0","typeLabel":"number"},{"type":"null","uniqueKey":"data.items.[INDEX].interest_rate.oneOf.2.pct_of_benchmark.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.items.[INDEX].interest_rate.oneOf.2.pct_of_benchmark","typeLabel":"number | null"},"spread_in_bps":{"oneOf":[{"type":"number","uniqueKey":"data.items.[INDEX].interest_rate.oneOf.2.spread_in_bps.oneOf.0","typeLabel":"number"},{"type":"null","uniqueKey":"data.items.[INDEX].interest_rate.oneOf.2.spread_in_bps.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.items.[INDEX].interest_rate.oneOf.2.spread_in_bps","typeLabel":"number | null"}},"isRequired":true,"uniqueKey":"data.items.[INDEX].interest_rate.oneOf.2","typeLabel":"object"},{"type":"null","isRequired":true,"uniqueKey":"data.items.[INDEX].interest_rate.oneOf.3","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.items.[INDEX].interest_rate","typeLabel":"number · null · object · null"},"interest_type":{"oneOf":[{"description":"The Type of interest:\n\n- `fixed rate`: The bond pays a fixed interest rate throughout its life.\n- `cab`: Capital Appreciation Bond (CAB), interest accrues and is paid at maturity rather than periodically.\n- `variable rate`: The bond's interest rate can change over time, typically based on a reference rate or formula (e.g., SOFR, CPI).\n- `term rate`: The bond pays interest at a rate set for a specific term or period.\n- `fixed to float`: The bond pays a fixed coupon for an initial period, then floats with a reference rate.\n- `float to fixed`: The bond pays a floating coupon for an initial period, then converts to a fixed rate.\n- `cab-to-fixed`: The bond starts as a capital appreciation bond and converts to a fixed rate bond.\n- `step rate`: The bond's interest rate increases (\"steps up\") at predetermined intervals.\n- `zero rate / discount rate`: A bond that does not pay or accrue interest.\n","enum":["cab","cab-to-fixed","fixed rate","fixed to float","float to fixed","step rate","term rate","variable rate","zero rate / discount rate"],"type":"string","isRequired":true,"uniqueKey":"data.items.[INDEX].interest_type.oneOf.0","typeLabel":"enum\u003cstring>"},{"description":"The Type of interest:\n\n- `fixed rate`: The bond pays a fixed interest rate throughout its life.\n- `cab`: Capital Appreciation Bond (CAB), interest accrues and is paid at maturity rather than periodically.\n- `variable rate`: The bond's interest rate can change over time, typically based on a reference rate or formula (e.g., SOFR, CPI).\n- `term rate`: The bond pays interest at a rate set for a specific term or period.\n- `fixed to float`: The bond pays a fixed coupon for an initial period, then floats with a reference rate.\n- `float to fixed`: The bond pays a floating coupon for an initial period, then converts to a fixed rate.\n- `cab-to-fixed`: The bond starts as a capital appreciation bond and converts to a fixed rate bond.\n- `step rate`: The bond's interest rate increases (\"steps up\") at predetermined intervals.\n- `zero rate / discount rate`: A bond that does not pay or accrue interest.\n","enum":["cab","cab-to-fixed","fixed rate","fixed to float","float to fixed","step rate","term rate","variable rate","zero rate / discount rate"],"type":"null","isRequired":true,"uniqueKey":"data.items.[INDEX].interest_type.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.items.[INDEX].interest_type","typeLabel":"enum\u003cstring> | null"},"is_callable":{"description":"Whether the bond is callable before maturity.\n","nullable":false,"type":"boolean","isRequired":true,"uniqueKey":"data.items.[INDEX].is_callable","typeLabel":"boolean"},"isin":{"description":"International Securities Identification Number (ISIN), unique 12-character code for the security.","example":"US64966HW301","maxLength":12,"minLength":12,"nullable":false,"type":"string","x-check":"valid_check_digit","x-check-error":"Invalid ISIN check digit","x-transform":"upcase","isRequired":true,"uniqueKey":"data.items.[INDEX].isin","typeLabel":"string"},"issuer_name":{"description":"Name of the issuing entity (municipality, district, etc.).","example":"School District Number 172","nullable":false,"type":"string","isRequired":true,"uniqueKey":"data.items.[INDEX].issuer_name","typeLabel":"string"},"maturity_date":{"description":"Date when the bond principal is due to be repaid in ISO-8601 format (YYYY-MM-DD).","format":"date","nullable":false,"type":"string","isRequired":true,"uniqueKey":"data.items.[INDEX].maturity_date","typeLabel":"string\u003cdate>"},"rating_group":{"oneOf":[{"description":"Credit rating group:\n\n- `investment_grade`: Bonds with high credit quality, typically considered safe and low risk.\n- `high_yield`: Bonds with lower credit quality, typically considered riskier and higher yield.\n","enum":["high_yield","investment_grade"],"type":"string","isRequired":true,"uniqueKey":"data.items.[INDEX].rating_group.oneOf.0","typeLabel":"enum\u003cstring>"},{"description":"Credit rating group:\n\n- `investment_grade`: Bonds with high credit quality, typically considered safe and low risk.\n- `high_yield`: Bonds with lower credit quality, typically considered riskier and higher yield.\n","enum":["high_yield","investment_grade"],"type":"null","isRequired":true,"uniqueKey":"data.items.[INDEX].rating_group.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.items.[INDEX].rating_group","typeLabel":"enum\u003cstring> | null"},"state":{"description":"US state or territory where the bond is issued (ANSI 2-letter code).\n","example":"IL","maxLength":2,"minLength":2,"nullable":false,"type":"string","isRequired":true,"uniqueKey":"data.items.[INDEX].state","typeLabel":"string"},"ticker":{"oneOf":[{"description":"Bond ticker symbol.","example":"IL ADASCD 5 02/01/2035","type":"string","isRequired":true,"uniqueKey":"data.items.[INDEX].ticker.oneOf.0","typeLabel":"string"},{"description":"Bond ticker symbol.","example":"IL ADASCD 5 02/01/2035","type":"null","isRequired":true,"uniqueKey":"data.items.[INDEX].ticker.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.items.[INDEX].ticker","typeLabel":"string | null"}},"required":["has_official_statement","interest_rate","interest_type","is_callable","isin","issuer_name","maturity_date","rating_group","state","ticker"],"type":"object","uniqueKey":"data.items.[INDEX]","typeLabel":"object"},"type":"array","isRequired":true,"uniqueKey":"data","typeLabel":"object[]"},"next_cursor":{"oneOf":[{"description":"Send as `cursor` to get the next page. `null` on the last page, or when `limit` is 0.","type":"string","isRequired":true,"uniqueKey":"next_cursor.oneOf.0","typeLabel":"string"},{"description":"Send as `cursor` to get the next page. `null` on the last page, or when `limit` is 0.","type":"null","isRequired":true,"uniqueKey":"next_cursor.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"next_cursor","typeLabel":"string | null"},"total":{"description":"Total number of results in the database that match the query filters.","type":"integer","isRequired":true,"uniqueKey":"total","typeLabel":"integer"}},"required":["data","next_cursor","total"],"title":"MuniSearchResponse","type":"object","uniqueKey":"","typeLabel":"MuniSearchResponse · object"},"examples":{"Example":{"title":"Example","value":{"data":[{"has_official_statement":true,"interest_rate":5,"interest_type":"fixed rate","is_callable":true,"isin":"US00037CUQ13","issuer_name":"ABAG Finance Authority for Nonprofit Corporations","maturity_date":"2035-11-15","rating_group":"investment_grade","state":"CA","ticker":"CA AFAGEN 5 11/15/2035"}],"next_cursor":null,"total":1}}},"exampleType":"examples"}},"description":"Partial reference data","exampleType":"examples"},"72e1c4ad-bbf5-4b59-859f-6ba1b1a73177":{"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"errors":{"items":{"additionalProperties":false,"properties":{"detail":{"example":"Unauthorized","type":"string","isRequired":true,"uniqueKey":"errors.items.[INDEX].detail","typeLabel":"string"},"reason":{"example":"Your account tier does not allow this operation. Contact team@terrapinfinance.com for an upgrade.","type":"string","uniqueKey":"errors.items.[INDEX].reason","typeLabel":"string"}},"required":["detail"],"type":"object","uniqueKey":"errors.items.[INDEX]","typeLabel":"object"},"type":"array","isRequired":true,"uniqueKey":"errors","typeLabel":"object[]"}},"required":["errors"],"type":"object","uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"errors":[{"detail":"Unauthorized","reason":"Your account tier does not allow this operation. Contact team@terrapinfinance.com for an upgrade."}]}}},"exampleType":"generated"}},"description":"Unauthorized","exampleType":"generated"},"ff59749d-73b7-4c95-93ad-eb7000fa19cc":{"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"errors":{"items":{"additionalProperties":false,"properties":{"detail":{"example":"Payment Required","type":"string","isRequired":true,"uniqueKey":"errors.items.[INDEX].detail","typeLabel":"string"},"reason":{"example":"You have run out of your granted quota for this resource as defined by your account tier. Contact team@terrapinfinance.com for an upgrade.","type":"string","uniqueKey":"errors.items.[INDEX].reason","typeLabel":"string"}},"required":["detail"],"type":"object","uniqueKey":"errors.items.[INDEX]","typeLabel":"object"},"type":"array","isRequired":true,"uniqueKey":"errors","typeLabel":"object[]"}},"required":["errors"],"type":"object","uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"errors":[{"detail":"Payment Required","reason":"You have run out of your granted quota for this resource as defined by your account tier. Contact team@terrapinfinance.com for an upgrade."}]}}},"exampleType":"generated"}},"description":"Payment Required","exampleType":"generated"},"54ddeaf9-d197-45ff-b7fd-75def98b0d79":{"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"errors":{"items":{"additionalProperties":false,"properties":{"detail":{"example":"Forbidden","type":"string","isRequired":true,"uniqueKey":"errors.items.[INDEX].detail","typeLabel":"string"},"reason":{"example":"Your account tier does not allow this operation. Contact team@terrapinfinance.com for an upgrade.","type":"string","uniqueKey":"errors.items.[INDEX].reason","typeLabel":"string"}},"required":["detail"],"type":"object","uniqueKey":"errors.items.[INDEX]","typeLabel":"object"},"type":"array","isRequired":true,"uniqueKey":"errors","typeLabel":"object[]"}},"required":["errors"],"type":"object","uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"errors":[{"detail":"Forbidden","reason":"Your account tier does not allow this operation. Contact team@terrapinfinance.com for an upgrade."}]}}},"exampleType":"generated"}},"description":"Forbidden","exampleType":"generated"},"e4102e49-2d12-47fb-9292-db069564f708":{"content":{"application/json":{"schema":{"properties":{"errors":{"items":{"properties":{"detail":{"example":"Invalid string. Got: integer","type":"string","isRequired":true,"uniqueKey":"errors.items.[INDEX].detail","typeLabel":"string"},"source":{"properties":{"pointer":{"example":"/isins/0","type":"string","isRequired":true,"uniqueKey":"errors.items.[INDEX].source.pointer","typeLabel":"string"}},"required":["pointer"],"type":"object","isRequired":true,"uniqueKey":"errors.items.[INDEX].source","typeLabel":"object"},"title":{"example":"Invalid value","type":"string","isRequired":true,"uniqueKey":"errors.items.[INDEX].title","typeLabel":"string"}},"required":["detail","source","title"],"type":"object","uniqueKey":"errors.items.[INDEX]","typeLabel":"object"},"type":"array","isRequired":true,"uniqueKey":"errors","typeLabel":"object[]"}},"required":["errors"],"type":"object","uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"errors":[{"detail":"Invalid string. Got: integer","source":{"pointer":"/isins/0"},"title":"Invalid value"}]}}},"exampleType":"generated"}},"description":"Unprocessable Entity","exampleType":"generated"},"ef9f38e2-e959-440d-babc-f3c6f419f251":{"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"errors":{"items":{"additionalProperties":false,"properties":{"detail":{"example":"Too Many Requests","type":"string","isRequired":true,"uniqueKey":"errors.items.[INDEX].detail","typeLabel":"string"},"reason":{"type":"string","uniqueKey":"errors.items.[INDEX].reason","typeLabel":"string"}},"required":["detail"],"type":"object","uniqueKey":"errors.items.[INDEX]","typeLabel":"object"},"type":"array","isRequired":true,"uniqueKey":"errors","typeLabel":"object[]"}},"required":["errors"],"type":"object","uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"errors":[{"detail":"Too Many Requests","reason":"\u003cstring>"}]}}},"exampleType":"generated"}},"description":"Too Many Requests","exampleType":"generated"},"1a3d1c8e-f195-4e3f-b3cb-c069401f67d2":{"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"errors":{"items":{"additionalProperties":false,"properties":{"detail":{"example":"Internal Server Error","type":"string","isRequired":true,"uniqueKey":"errors.items.[INDEX].detail","typeLabel":"string"},"reason":{"type":"string","uniqueKey":"errors.items.[INDEX].reason","typeLabel":"string"}},"required":["detail"],"type":"object","uniqueKey":"errors.items.[INDEX]","typeLabel":"object"},"type":"array","isRequired":true,"uniqueKey":"errors","typeLabel":"object[]"}},"required":["errors"],"type":"object","uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"errors":[{"detail":"Internal Server Error","reason":"\u003cstring>"}]}}},"exampleType":"generated"}},"description":"Internal Server Error","exampleType":"generated"}},"security":{"142f149d-09d5-4d79-a55f-9635b5ba8d6a":{"authorization":{"scheme":"bearer","type":"http","scopes":[],"schemeName":"authorization"}}},"servers":{"4da2332b-a441-44a2-a604-2a3adeef8694":{"url":"https://terrapinfinance.com","variables":{}}},"processedSecurityOptions":[{"schemes":[{"scheme":{"scheme":"bearer","type":"http","scopes":[],"schemeName":"authorization"},"schema":{"title":"Bearer Auth","type":"string","isRequired":true,"description":"Bearer authentication header of the form `Bearer \u003ctoken>`, where `\u003ctoken>` is your auth token.","format":"bearer","typeLabel":"string\u003cbearer>","deprecated":false},"schemeName":"authorization","name":"Authorization"}],"title":"authorization"}]},"originalFileLocation":"openapi_spec.json"},"subdomain":"terrapinfinance","siteName":"Terrapin","title":"Bond Search - Terrapin","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-10-15T16:07:25.274Z","originalFileLocation":"api-endpoints/us-municipal-bond-search.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=\"dark\";if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"dark\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"This endpoint returns a list of US municipal bonds with a small set of fields. It is intended for search according to the filters provided.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Terrapin\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/terrapinfinance/hT4LTryueBhkI9IR/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/mintlify-assets/_mintlify/favicons/terrapinfinance/hT4LTryueBhkI9IR/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/terrapinfinance/hT4LTryueBhkI9IR/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/terrapinfinance/hT4LTryueBhkI9IR/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/terrapinfinance/hT4LTryueBhkI9IR/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/terrapinfinance/hT4LTryueBhkI9IR/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/terrapinfinance/hT4LTryueBhkI9IR/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/terrapinfinance/hT4LTryueBhkI9IR/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/terrapinfinance/hT4LTryueBhkI9IR/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Bond Search - Terrapin\">\u003cmeta data-mint-head property=\"og:description\" content=\"This endpoint returns a list of US municipal bonds with a small set of fields. It is intended for search according to the filters provided.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Terrapin\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.terrapinfinance.com/api-endpoints/us-municipal-bond-search\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://terrapinfinance.com/images/og/documentation.png\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"Bond Search - Terrapin\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"This endpoint returns a list of US municipal bonds with a small set of fields. It is intended for search according to the filters provided.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://terrapinfinance.com/images/og/documentation.png\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/mintlify-assets/_mintlify/favicons/terrapinfinance/hT4LTryueBhkI9IR/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Terrapin\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#5cc9c4\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.terrapinfinance.com/api-endpoints/us-municipal-bond-search\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-endpoints/us-municipal-bond-search.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.terrapinfinance.com/#organization\",\"name\":\"Terrapin\",\"url\":\"https://docs.terrapinfinance.com\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/terrapinfinance/izOIwTIm47tha4Ui/logo.png?fit=max\u0026auto=format\u0026n=izOIwTIm47tha4Ui\u0026q=85\u0026s=259202f1a61642e74e1194ad39a9e024\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.terrapinfinance.com#website\",\"name\":\"Terrapin\",\"url\":\"https://docs.terrapinfinance.com\",\"publisher\":{\"@id\":\"https://docs.terrapinfinance.com/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.terrapinfinance.com/api-endpoints/us-municipal-bond-search#webpage\",\"url\":\"https://docs.terrapinfinance.com/api-endpoints/us-municipal-bond-search\",\"name\":\"Bond Search\",\"description\":\"This endpoint returns a list of US municipal bonds with a small set of fields. It is intended for search according to the filters provided.\",\"dateModified\":\"2026-10-15T16:07:25.274Z\",\"isPartOf\":{\"@id\":\"https://docs.terrapinfinance.com#website\"},\"breadcrumb\":{\"@id\":\"https://docs.terrapinfinance.com/api-endpoints/us-municipal-bond-search#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.terrapinfinance.com/api-endpoints/us-municipal-bond-search#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Terrapin\",\"item\":\"https://docs.terrapinfinance.com\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Bond Search\",\"item\":\"https://docs.terrapinfinance.com/api-endpoints/us-municipal-bond-search\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.terrapinfinance.com/api-endpoints/us-municipal-bond-search#apireference\",\"headline\":\"Bond Search\",\"name\":\"Bond Search\",\"description\":\"This endpoint returns a list of US municipal bonds with a small set of fields. It is intended for search according to the filters provided.\",\"url\":\"https://docs.terrapinfinance.com/api-endpoints/us-municipal-bond-search\",\"mainEntityOfPage\":{\"@id\":\"https://docs.terrapinfinance.com/api-endpoints/us-municipal-bond-search#webpage\"},\"image\":\"https://terrapinfinance.com/images/og/documentation.png\",\"dateModified\":\"2026-10-15T16:07:25.274Z\",\"publisher\":{\"@id\":\"https://docs.terrapinfinance.com/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.terrapinfinance.com#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Terrapin\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"Terrapin\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/api-endpoints/us-municipal-bond-search.md","siteName":"Terrapin","nav":{"global":null,"tabs":[{"tab":"API Reference","groups":[{"group":"Getting started","pages":[{"title":"Welcome to Terrapin","mode":"wide","href":"/introduction"},{"title":"Authentication","mode":"wide","href":"/authentication"},{"title":"Rate limits \u0026 quotas","mode":"wide","href":"/rate-limits-and-quotas"},{"title":"Pagination","mode":"wide","href":"/pagination"},{"title":"Errors","mode":"wide","href":"/errors"}]},{"group":"Data dictionaries","pages":[{"title":"Fixed income securities","mode":"wide","href":"/data_dictionary_securities"},{"title":"US municipal securities","mode":"wide","href":"/data_dictionary_munis"},{"title":"US agency bonds","mode":"wide","href":"/data_dictionary_agencies"},{"title":"Government \u0026 corporate bonds","mode":"wide","href":"/data_dictionary_govies_corps"}]},{"group":"Other concepts","pages":[{"title":"Inflation factors","mode":"wide","href":"/inflation_factors"},{"title":"Use of Funds Taxonomy","mode":"wide","href":"/use_of_funds_taxonomy"}]},{"group":"Fixed income securities","pages":[{"title":"Bond Search","openapi":"post /api/v1/securities_search","href":"/api-endpoints/securities-search"},{"title":"Reference Data","openapi":"post /api/v1/securities_reference","href":"/api-endpoints/securities-reference"},{"title":"Latest Pricing","openapi":"post /api/v1/securities_pricing_latest","href":"/api-endpoints/securities-pricing-latest"},{"title":"Historical Pricing","openapi":"post /api/v1/securities_pricing_history","href":"/api-endpoints/securities-pricing-history"},{"title":"Cash Flows","openapi":"post /api/v1/securities_cashflows","description":"Get cash flow schedules for fixed or zero rate bonds.","href":"/api-endpoints/securities-cashflows"}]},{"group":"US municipal securities","pages":[{"title":"Bond Search","openapi":"post /api/v1/muni_search","href":"/api-endpoints/us-municipal-bond-search"},{"title":"Entity Search","openapi":"post /api/v1/muni_entity_search","description":"Given a search query, returns a list of municipal bond issuers (entities) matching the query. Searches by entity name, state, and counties.","href":"/api-endpoints/us-municipal-bond-entity-search"},{"title":"Reference Data","openapi":"post /api/v1/muni_reference","href":"/api-endpoints/us-municipal-bond-reference"},{"title":"Documents","openapi":"post /api/v1/muni_documents","href":"/api-endpoints/us-municipal-bond-documents"},{"title":"Latest Pricing","openapi":"post /api/v1/muni_pricing_latest","href":"/api-endpoints/us-municipal-bond-latest-pricing-data"},{"title":"Historical Pricing","openapi":"post /api/v1/muni_pricing_history","href":"/api-endpoints/us-municipal-bond-historical-pricing-data"},{"title":"Bulk Pricing","openapi":"post /api/v1/muni_pricing_daily_history","tag":"REST-only","href":"/api-endpoints/us-municipal-bond-daily-historical-pricing-data"},{"title":"Price To Yield","openapi":"post /api/v1/muni_price_to_yield","href":"/api-endpoints/us-municipal-bond-price-to-yield"},{"title":"Cash Flows","openapi":"post /api/v1/muni_cashflows","href":"/api-endpoints/us-municipal-bond-cashflows"},{"title":"Bonds in Series","openapi":"post /api/v1/muni_bonds_in_series","href":"/api-endpoints/us-municipal-bond-bonds-in-series"},{"title":"Event History","openapi":"post /api/v1/muni_events","href":"/api-endpoints/us-municipal-bond-events"}]},{"group":"US municipal bond statistics","pages":[{"title":"Outstanding Statistics","openapi":"post /api/v1/muni_stats_outstanding","href":"/api-endpoints/us-municipal-bond-stats-outstanding"},{"title":"Issuance Statistics","openapi":"post /api/v1/muni_stats_issuance","href":"/api-endpoints/us-municipal-bond-stats-issuance"},{"title":"Trade Activity Statistics","openapi":"post /api/v1/muni_stats_trade_activity","href":"/api-endpoints/us-municipal-bond-stats-trade-activity"},{"title":"Top Issuers","openapi":"post /api/v1/muni_stats_top_issuers","href":"/api-endpoints/us-municipal-bond-stats-top-issuers"}]},{"group":"Government Yield Curves","pages":[{"title":"Curve data","openapi":"post /api/v1/government_yield_curve","href":"/api-endpoints/government-yield-curve"}]},{"group":"Inflation Factors","pages":[{"title":"Inflation Factors","openapi":"post /api/v1/inflation_factors","href":"/api-endpoints/government-inflation-factors"}]},{"group":"US agency bonds (deprecated)","pages":[{"title":"Bond Search","openapi":"post /api/v1/agency_search","href":"/api-endpoints/us-agency-bond-search"},{"title":"Reference Data","openapi":"post /api/v1/agency_reference","href":"/api-endpoints/us-agency-bond-reference"},{"title":"Latest Pricing","openapi":"post /api/v1/agency_pricing_latest","href":"/api-endpoints/us-agency-latest-pricing-data"},{"title":"Historical Pricing","openapi":"post /api/v1/agency_pricing_history","href":"/api-endpoints/us-agency-historical-pricing-data"},{"title":"Cash Flows","openapi":"post /api/v1/agency_cashflows","href":"/api-endpoints/us-agency-cashflows"}]},{"group":"Government \u0026 corporate bonds (deprecated)","pages":[{"title":"Bond Search","openapi":"post /api/v1/bond_search","href":"/api-endpoints/government-and-corporate-bond-search"},{"title":"Reference Data","openapi":"post /api/v1/bond_reference","href":"/api-endpoints/government-and-corporate-reference-data"},{"title":"Latest Pricing","openapi":"post /api/v1/bond_pricing_latest","href":"/api-endpoints/government-and-corporate-latest-pricing-data"},{"title":"Historical Pricing","openapi":"post /api/v1/bond_pricing_history","href":"/api-endpoints/government-and-corporate-historical-pricing-data"},{"title":"Cash Flows","openapi":"post /api/v1/bond_cashflows","href":"/api-endpoints/government-and-corporate-cashflows"}]},{"group":"Utilities","pages":[{"title":"Convert CUSIPs to ISINs","openapi":"post /api/v1/convert_to_isin","href":"/api-endpoints/convert-to-isin"},{"title":"Download Document","openapi":"post /api/v1/download_document","href":"/api-endpoints/download-document"}]}]},{"tab":"MCP","pages":[{"title":"MCP","href":"/mcp/introduction"}]},{"tab":"Credit Intel Platform","pages":[{"title":"Credit Intel Platform","href":"/platform-guide/introduction"}]}]},"basePath":"","title":"Bond Search - Terrapin","buildId":"dpl_G2Qd45vZZ7MkBiGF9yYx8ZsbbKXX","deploymentId":"dpl_G2Qd45vZZ7MkBiGF9yYx8ZsbbKXX","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-NXj-Rqjv.js","utils-m0thOP-_.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-D13EKcfm.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema--XTdfsEb.js","snippetPresets-D3s4lmAH.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","conditional-requirements-CFM0id0Q.js","ApiExamples-ChURybxL.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-DL8CiXq2.js","shallow-DI2-YB2E.js","getApiPlaygroundDisplay-DxbW7b_y.js","CodeSnippet-CiNYS0pP.js","CodeSnippets-BT87bThu.js","Page-DSpdRuhM.js","getPastedJson-F_g_IrFQ.js","icon-CCIG5BAs.js","MethodPill-DY3E0jwx.js","DuplicateIcon-BN88xnEg.js","createIcon-VCCc5HO5.js","DynamicMarkdown-CaSwclgK.js","SectionHeading-DXV8nWhc.js","axios-vUo_bRtp.js","Markdown-CV32Re6G.js","clsx-5ydLOnhV.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-pFDdfjRe.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-BUGO5bPJ.js"]}