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

​
Authorization
string
header
required

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

Body

application/json
​
isins
string[]
required

International Securities Identification Numbers of the bonds.

Response

200
application/json
Reference data
​
data
object[]
required

List of response data objects per bond. Contains at most 1000 objects.

Response schema per bond.

​
total
integer
required

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

Bond Search