Bonds in Series

Get all municipal bonds in the same series

curl --request POST \
  --url https://terrapinfinance.com/api/v1/muni_bonds_in_series \
  --header 'Accept: <accept>' \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "isin": "US794760LQ96"
}
'

{
  "data": [
    {
      "coupon": 4,
      "has_official_statement": true,
      "interest_type": "fixed rate",
      "is_callable": true,
      "isin": "US794760LQ96",
      "issuer_name": "SALINA AIRPORT AUTHORITY (SALINA, KANSAS)",
      "maturity_date": "2043-09-01",
      "rating_group": "investment_grade",
      "state": "KS",
      "ticker": "KS SALAPT 4 09/01/2043"
    },
    {
      "coupon": 4,
      "has_official_statement": true,
      "interest_type": "fixed rate",
      "is_callable": true,
      "isin": "US794760LM82",
      "issuer_name": "SALINA AIRPORT AUTHORITY (SALINA, KANSAS)",
      "maturity_date": "2040-09-01",
      "rating_group": "investment_grade",
      "state": "KS",
      "ticker": "KS SALAPT 4 09/01/2040"
    }
  ],
  "total": 2
}

POST

api

muni_bonds_in_series

Get all municipal bonds in the same series

curl --request POST \
  --url https://terrapinfinance.com/api/v1/muni_bonds_in_series \
  --header 'Accept: <accept>' \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "isin": "US794760LQ96"
}
'

{
  "data": [
    {
      "coupon": 4,
      "has_official_statement": true,
      "interest_type": "fixed rate",
      "is_callable": true,
      "isin": "US794760LQ96",
      "issuer_name": "SALINA AIRPORT AUTHORITY (SALINA, KANSAS)",
      "maturity_date": "2043-09-01",
      "rating_group": "investment_grade",
      "state": "KS",
      "ticker": "KS SALAPT 4 09/01/2043"
    },
    {
      "coupon": 4,
      "has_official_statement": true,
      "interest_type": "fixed rate",
      "is_callable": true,
      "isin": "US794760LM82",
      "issuer_name": "SALINA AIRPORT AUTHORITY (SALINA, KANSAS)",
      "maturity_date": "2040-09-01",
      "rating_group": "investment_grade",
      "state": "KS",
      "ticker": "KS SALAPT 4 09/01/2040"
    }
  ],
  "total": 2
}

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

isin

string

required

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

Required string length: 12

Response

Municipal bonds in the same series

data

object[]

required

List of response data objects, often capped to 1000.

Show child attributes

data.coupon

number | null

required

Interest rate or coupon of the bond.

data.has_official_statement

boolean

required

Whether the bond has an official statement published.

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_callable

boolean

required

Whether the bond is callable before maturity.

data.isin

string

required

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

Required string length: 12

Example:

"US64966HW301"

data.issuer_name

string

required

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

Example:

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

data.maturity_date

string<date>

required

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

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

string

required

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

Required string length: 2

Example:

"IL"

data.ticker

string | null

required

Bond ticker symbol.

Example:

"IL ADASCD 5 02/01/2035"

total

integer

required

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

Cash Flows Use of Funds Taxonomy

⌘I

Overview

Government and corporate bonds

US municipal bonds

Authorizations

Headers

Body

Response