Skip to main content
POST
Corporate, government and certificate of deposit search
These endpoints replace the deprecated Government & corporate endpoints and will soon deprecate the US agency endpoints.

Authorizations

Authorization
string
header
required

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

Body

application/json
asset_classes
enum<string>[]

Asset class(es) to filter by. Supported values are corporate, gov and certificates_of_deposit. Defaults to all of them.

Available options:
certificates_of_deposit,
corporate,
gov
country_codes
string[]

Countries of issuing entity (ISO 3166-1 alpha-2 country codes):

Examples:

  • DE: Country of issue is Germany.
  • FR: Country of issue is France.
  • US: Country of issue is United States of America.
Required string length: 2
currencies
string[]

Bond currencies, 3-letter ISO 4217 code.

Required string length: 3
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.

full_reference_data
boolean

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

include_non_outstanding
boolean
default:false

Whether to include non-outstanding bonds (matured or redeemed bonds), vastly increases results.

interest_rate_max
number

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

interest_rate_min
number

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

interest_types
enum<string>[]

Types of interest:

  • fixed rate: The bond pays a fixed interest rate throughout its life.
  • zero rate / discount rate: A bond that does not pay or accrue interest.
  • variable rate: The bond's interest rate can change over time, typically based on a reference rate or formula (e.g., SOFR, CPI).
  • step rate: The bond's interest rate increases ("steps up") at predetermined intervals.
  • 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.
  • reset rate: The interest rate resets periodically to a new predetermined level, as distinct from a rate that floats continuously with a benchmark.
  • misc.: Miscellaneous interest types.
  • payment in kind: Interest paid in additional securities.
Available options:
at maturity,
cash payment,
dividend payments,
fixed rate,
fixed to float,
float to fixed,
misc.,
payment in kind,
reset rate,
step rate,
variable rate,
zero rate / discount rate
is_callable
boolean

Filter by whether the bond is callable.

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 corporate bond in ISO-8601 format (YYYY-MM-DD).

issue_date_min
string<date>

Minimum issue date of the corporate 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 | null

Name of the issuing entity.

leis
string[]

Legal Entity Identifiers (LEI) of the issuer:

A 20-character, alpha-numeric code based on the ISO 17442 standard used to uniquely identify legal entities in financial transactions. Most LEIs follow this structure, but there are exceptions that use local national standards.

Required string length: 20
leis_direct_parent
string[]

LEIs of the direct parent of the issuer:

A 20-character, alpha-numeric code based on the ISO 17442 standard used to uniquely identify legal entities in financial transactions. Most LEIs follow this structure, but there are exceptions that use local national standards.

Required string length: 20
leis_ultimate_parent
string[]

LEIs of the ultimate parent of the issuer:

A 20-character, alpha-numeric code based on the ISO 17442 standard used to uniquely identify legal entities in financial transactions. Most LEIs follow this structure, but there are exceptions that use local national standards.

Required string length: 20
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 corporate bond in ISO-8601 format (YYYY-MM-DD).

maturity_date_min
string<date>

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

maturity_types
enum<string>[]

Maturity types:

  • fixed: Principal repaid at maturity.
  • amortized: Principal repaid gradually before maturity.
  • perpetual: No maturity date; principal is never repaid.
  • extendible: Maturity date can be extended by issuer or holder.
Available options:
amortized,
extendible,
fixed,
perpetual
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
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:
-asset_class,
-interest_rate,
-interest_type,
-is_callable,
-isin,
-issuer_name,
-maturity_date,
-ticker,
asset_class,
interest_rate,
interest_type,
is_callable,
isin,
issuer_name,
maturity_date,
ticker
values_updated_since
string<date-time>

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

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.