US municipal bonds
Reference Data
Overview
Government and corporate bonds
US municipal bonds
US municipal bonds
Reference Data
POST
/
api
/
v1
/
muni_reference
curl --request POST \
--url https://terrapinfinance.com/api/v1/muni_reference \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
"isins": [
"US005824LP01"
]
}'
{
"data": [
{
"issue_price": 111.945,
"country_code": "US",
"rating": "investment_grade",
"optional_redemption_schedule": [
{
"call_date": "2032-02-01",
"call_price": 100,
"includes_accrued_interest": true,
"is_periodic": true,
"period_amount": 1,
"period_type": "day",
"until": null
}
],
"ticker": "IL ADASCD 5 02/01/2035",
"is_callable": true,
"series": "SCHOOL DISTRICT NUMBER 172 ADAMS COUNTY, ILLINOIS (QUINCY) GENERAL OBLIGATION SCHOOL BONDS, SERIES 2024 (IL)",
"interest_type": "fixed rate",
"is_federally_taxable": true,
"figi": "BBG01L7LZSL5",
"issuer_name": "SCHOOL DISTRICT NUMBER 172 ADAMS COUNTY, ILLINOIS (QUINCY)",
"coupon_payment_day": 1,
"first_interest_payment_date": "2024-08-01",
"is_insured": true,
"interest_accrual_date": "2024-02-20",
"source_of_repayment": "General Obligation",
"interest_accrual_convention": "30/360",
"maturity_date": "2035-02-01",
"integral_multiple": 5000,
"first_execution_date": "2024-01-31",
"purpose": "Education",
"award_date": "2024-01-30",
"issue_yield": 3.28,
"coupon": 5,
"currency": "USD",
"is_state_taxable": false,
"is_amt": false,
"coupon_payment_months": [
2,
8
],
"country": "United States of America",
"minimum_denomination": 5000,
"dated_date": "2024-02-20",
"closing_date": "2024-02-20",
"coupon_frequency": 2,
"state": "IL",
"handle": "us_muni",
"isin": "US005824LP01",
"issue_date": "2024-01-30",
"issuer_type": "municipal",
"first_trade_date": "2024-01-31",
"sector": "education",
"issued_amount": 240000
}
],
"total": 1
}
Authorizations
Bearer authentication header of the form Bearer <token>
, where <token>
is your auth token.
Body
application/json
International Securities Identification Numbers of the bonds.
Response
200
application/json
Reference data
List of response data objects per bond. Contains at most 1000 objects.
Response schema per bond.
Available options:
high_yield
, investment_grade
Total number of results in the database that match the query filters.
curl --request POST \
--url https://terrapinfinance.com/api/v1/muni_reference \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
"isins": [
"US005824LP01"
]
}'
{
"data": [
{
"issue_price": 111.945,
"country_code": "US",
"rating": "investment_grade",
"optional_redemption_schedule": [
{
"call_date": "2032-02-01",
"call_price": 100,
"includes_accrued_interest": true,
"is_periodic": true,
"period_amount": 1,
"period_type": "day",
"until": null
}
],
"ticker": "IL ADASCD 5 02/01/2035",
"is_callable": true,
"series": "SCHOOL DISTRICT NUMBER 172 ADAMS COUNTY, ILLINOIS (QUINCY) GENERAL OBLIGATION SCHOOL BONDS, SERIES 2024 (IL)",
"interest_type": "fixed rate",
"is_federally_taxable": true,
"figi": "BBG01L7LZSL5",
"issuer_name": "SCHOOL DISTRICT NUMBER 172 ADAMS COUNTY, ILLINOIS (QUINCY)",
"coupon_payment_day": 1,
"first_interest_payment_date": "2024-08-01",
"is_insured": true,
"interest_accrual_date": "2024-02-20",
"source_of_repayment": "General Obligation",
"interest_accrual_convention": "30/360",
"maturity_date": "2035-02-01",
"integral_multiple": 5000,
"first_execution_date": "2024-01-31",
"purpose": "Education",
"award_date": "2024-01-30",
"issue_yield": 3.28,
"coupon": 5,
"currency": "USD",
"is_state_taxable": false,
"is_amt": false,
"coupon_payment_months": [
2,
8
],
"country": "United States of America",
"minimum_denomination": 5000,
"dated_date": "2024-02-20",
"closing_date": "2024-02-20",
"coupon_frequency": 2,
"state": "IL",
"handle": "us_muni",
"isin": "US005824LP01",
"issue_date": "2024-01-30",
"issuer_type": "municipal",
"first_trade_date": "2024-01-31",
"sector": "education",
"issued_amount": 240000
}
],
"total": 1
}