---
title: "Search Bond Filter Information"
method: GET
path: "/iserver/secdef/bond-filters"
tags: ["tradingContracts"]
---

# Search Bond Filter Information

`GET /iserver/secdef/bond-filters`

Request a list of filters relating to a given Bond issuerID. The issuerId is retrieved from /iserver/secdef/search and can be used in /iserver/secdef/info?issuerId={issuerId} for retrieving conIds.

## Query parameters

- `symbol` string, required
- `issuerId` string, required

## Response `200`

Successful requests return the currency exchange rate of the target currency value divided by the source currency.

- BondFiltersResponse
  - `bondFilters` BondFiltersResponseBondFiltersItems[] — Contains all filters pertaining to the given issuerId
    - `displayText` 'Maturity Date' | 'Issue Date' | 'Coupon' | 'Currency' — An identifier used to document returned options/values. This can be thought of as a key value.
    - `columnId` integer — Used for user interfaces. Internal use only.
    - `options` BondFiltersResponseBondFiltersItemsOptionsItems[] — Contains all objects with values corresponding to the parent displayText key.
      - `text` string — In some instances, a text value will be returned, which indicates the standardized value format such as plaintext dates, rather than solely numerical values.
      - `value` string, required — Returns value directly correlating to the displayText key. This may include exchange, maturity date, issue date, coupon, or currency.

## Other responses

- `401` — Missing, invalid, or unparseable Authorization token.
- `500` — internal server error, returned when incoming request cannot be processed. It can sometimes include subset of bad requests. For example, wrong accountId passed and it can only be detected later in handling request. Error contains reason of the problem.
- `503` — service is unavailable. For example if request takes more than 10s due to some internal service unavailability, request aborted and this status returned

---

[API](https://skmtc.net/interactivebrokers/apis/api-reference.md) · [All operations](https://skmtc.net/interactivebrokers/apis/api-reference/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/interactivebrokers/api-reference/revisions/67f9f562c2c6/schema)