---
title: "Fixed income"
method: GET
path: "/bonds"
tags: ["reference_data"]
---

# Fixed income

`GET /bonds`

The fixed income endpoint provides a daily updated list of available bonds. It returns an array containing detailed information about each bond, including identifiers, names, and other relevant attributes.

## Query parameters

- `symbol` string
- `exchange` string
- `mic_code` string
- `country` string
- `format` 'JSON' | 'CSV'
- `delimiter` string
- `show_plan` boolean
- `page` integer
- `outputsize` integer

## Response `200`

- object
  - `result` object, required
    - `count` integer, required — Total number of matching instruments
    - `list` BondResponseItem[], required — List of bonds
      - `symbol` string, required — Bond symbol
      - `name` string, required — Full name of the bond
      - `country` string, required — Country where the bond is located
      - `currency` string, required — Currency of the bond according to the ISO 4217 standard
      - `exchange` string, required — Exchange where the bond is traded
      - `mic_code` string, required — Market identifier code (MIC) under ISO 10383 standard
      - `type` string, required — Type of the bond
      - `access` BondsResponseItemAccess — Info on which plan symbol is available (displayed then `show_plan` is `true`)
        - `global` string, required — Level of access to the symbol
        - `plan` string, required — The individual plan name for the symbol
        - `plan_business` string, required — The business plan name for the symbol
  - `status` string, required — Response status

## Other responses

- `400`
- `401`
- `403`
- `404`
- `414`
- `429`
- `500`

---

[API](https://skmtc.net/twelvedata/apis/twelve-data-api.md) · [All operations](https://skmtc.net/twelvedata/apis/twelve-data-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/twelvedata/twelve-data-api/revisions/c4a12725cdb5/schema)