> ## Documentation Index > Fetch the complete documentation index at: https://docs.bigdata.com/llms.txt > Use this file to discover all available pages before exploring further. # Bonds by Issuer > Returns the bonds a company has issued, with their terms: ISIN, description, issue and maturity dates, coupon and payment frequency, currency, issued and outstanding amounts, seniority (rank), status and structural features. Only active bonds are returned unless `status` asks for inactive or defaulted ones, or is null for every status. Results are paged: send back `pagination.cursor` to get the next page. A page can hold fewer bonds than the next one, or none, while `has_cursor` is still true. ## OpenAPI ````yaml /api-rest/openapi/openapi_structured_data.json post /v1/fixed-income/corporate/issuer/query openapi: 3.1.0 info: title: Bigdata Structured Data API description: Bigdata API documentation version: 1.0.0 servers: - url: https://api.bigdata.com/ security: - ApiKeyAuth: [] tags: - name: Market Data description: >- Market data endpoints including intraday prices, daily prices, price changes, and real-time quotes - name: Analyst Estimates description: >- Analyst estimates and ratings including analyst ratings, estimates, target prices, and earnings surprises - name: Financials & Ratios description: >- Financial statements and ratios including balance sheet, income statement, cash flow statement, key metrics TTM, and company ratios TTM - name: Company & Events description: >- Company information and events including company profile and events calendar - name: Fund Holdings description: >- Institutional fund holdings from SEC 13F filings including fund holdings and stock fund holdings - name: Knowledge Graph description: Corporate ownership and hierarchy data. - name: Private Markets description: >- Private company data including profile, headquarters, funding totals and valuation - name: Fixed Income description: 'Bond reference data: the bonds a company has issued and their terms' paths: /v1/fixed-income/corporate/issuer/query: post: tags: - Fixed Income summary: Bonds by Issuer description: >- Returns the bonds a company has issued, with their terms: ISIN, description, issue and maturity dates, coupon and payment frequency, currency, issued and outstanding amounts, seniority (rank), status and structural features. Only active bonds are returned unless `status` asks for inactive or defaulted ones, or is null for every status. Results are paged: send back `pagination.cursor` to get the next page. A page can hold fewer bonds than the next one, or none, while `has_cursor` is still true. operationId: query_bonds_by_issuer_v1_fixed_income_corporate_issuer_query__post requestBody: content: application/json: schema: $ref: '#/components/schemas/BondsByIssuerQuery' required: true responses: '200': description: Successful Response content: application/json: schema: $ref: '#/components/schemas/BondsByIssuerResponse' '400': description: Bad Request content: application/json: schema: $ref: '#/components/schemas/BadRequestError' '429': description: Too Many Requests content: application/json: schema: $ref: '#/components/schemas/TooManyRequestsError' '500': description: Internal Server Error content: application/json: schema: $ref: '#/components/schemas/InternalServerError' components: schemas: BondsByIssuerQuery: properties: identifier: $ref: '#/components/schemas/SingleIdentifier' description: >- Object specifying which identifier you are using to request the company profile. You must supply one type and its corresponding value. status: anyOf: - $ref: '#/components/schemas/BondStatus' - type: 'null' description: >- Only return bonds in this status: 'active', 'inactive' or 'defaulted'. Defaults to 'active'; send null to return bonds in every status. default: active examples: - active cursor: anyOf: - type: string - type: 'null' title: Cursor description: >- Token for the next page. Send back 'pagination.cursor' from the previous response, with the same identifier and status. Omit it for the first page. additionalProperties: false type: object required: - identifier title: BondsByIssuerQuery example: identifier: type: rp_entity_id value: D8442A status: active BondsByIssuerResponse: properties: results: items: $ref: '#/components/schemas/Bond' type: array title: Results description: >- The company's bonds on this page. A page can hold fewer bonds than others, or none at all, while more remain: keep requesting the next page with 'cursor' until 'pagination.has_cursor' is false. errors: anyOf: - items: $ref: '#/components/schemas/ErrorDetail' type: array - type: 'null' title: Errors metadata: anyOf: - $ref: '#/components/schemas/Metadata' - type: 'null' pagination: anyOf: - $ref: '#/components/schemas/Pagination' - type: 'null' type: object required: - results title: BondsByIssuerResponse BadRequestError: properties: statusCode: type: integer const: 400 title: Statuscode default: 400 message: type: string title: Message type: object required: - message title: BadRequestError description: Bad Request Error example: message: Bad Request Error statusCode: 400 TooManyRequestsError: properties: statusCode: type: integer const: 429 title: Statuscode default: 429 message: type: string title: Message type: object required: - message title: TooManyRequestsError description: Too many requests. Please try again later. example: message: Too many requests. Please try again later. statusCode: 429 InternalServerError: properties: statusCode: type: integer const: 500 title: Statuscode default: 500 message: type: string title: Message type: object required: - message title: InternalServerError description: Internal Server Error example: message: Internal Server Error statusCode: 500 SingleIdentifier: properties: type: $ref: '#/components/schemas/IdentifierType' description: >- Object specifying which identifier you are using to request the intraday price. You must supply one type and its corresponding value. Only one identifier should be provided per request. examples: - rp_entity_id value: type: string title: Value description: >- Bigdata uses the RavenPack Entity identifier (RP_Entity_ID) to uniquely reference entities such as companies. This identifier is a 6-character alphanumeric code (letters and numbers only). Example: Alphabet Inc. (`4A6F00`) examples: - 4A6F00 type: object required: - type - value title: SingleIdentifier BondStatus: type: string enum: - active - inactive - defaulted title: BondStatus description: >- Where a bond stands in its life. 'active' bonds are outstanding and have not reached their maturity date, 'inactive' bonds have reached it or been redeemed, and 'defaulted' bonds are in default. Bond: properties: isin: type: string title: Isin description: ISIN of the bond. examples: - US037833EQ92 issuer_name: anyOf: - type: string - type: 'null' title: Issuer Name description: Name of the entity that issued the bond. examples: - Apple Inc issuer_rp_entity_id: type: string maxLength: 6 minLength: 6 title: Issuer Rp Entity Id description: RavenPack entity identifier of the company the bond belongs to. examples: - D8442A description: anyOf: - type: string - type: 'null' title: Description description: >- The provider's short description of the bond. For display only; do not parse it. examples: - 3.95% NT REDEEM 08/08/2052 USD 2000 issue_date: anyOf: - type: string format: date - type: 'null' title: Issue Date description: Date the bond was issued. examples: - '2022-08-08' maturity_date: anyOf: - type: string format: date - type: 'null' title: Maturity Date description: Date the bond matures. Absent for a perpetual bond. examples: - '2052-08-08' coupon: anyOf: - type: number - type: 'null' title: Coupon description: >- Annual interest rate in percent (3.5 means 3.50%). Absent for a zero-coupon or floating-rate bond, or when the rate is not available. examples: - 3.95 interest_payment_frequency: anyOf: - $ref: '#/components/schemas/PaymentFrequency' - type: 'null' description: How often the bond pays interest. examples: - semi-annual currency: anyOf: - type: string - type: 'null' title: Currency description: >- ISO 4217 code of the currency the bond is issued in, which is also the currency of the amounts. examples: - USD issue_amount_mm: anyOf: - type: number - type: 'null' title: Issue Amount Mm description: Amount issued, in millions of 'currency'. examples: - 1750 outstanding_amount_mm: anyOf: - type: number - type: 'null' title: Outstanding Amount Mm description: Amount still outstanding, in millions of 'currency'. examples: - 1750 rank: anyOf: - $ref: '#/components/schemas/BondRank' - type: 'null' description: >- Where the bond ranks for repayment. Seniority only; whether it is backed by collateral is 'is_secured'. examples: - senior status: anyOf: - $ref: '#/components/schemas/BondStatus' - type: 'null' description: >- Where the bond stands: 'active' (outstanding and before its maturity date), 'inactive' (on or after its maturity date, or redeemed) or 'defaulted'. examples: - active bond_type: anyOf: - $ref: '#/components/schemas/BondType' - type: 'null' description: The kind of instrument. examples: - note is_callable: anyOf: - type: boolean - type: 'null' title: Is Callable description: >- Whether the issuer can redeem the bond before maturity. Absent when the source does not say. is_secured: anyOf: - type: boolean - type: 'null' title: Is Secured description: >- Whether the bond is backed by specific collateral. Absent when the source does not say. is_guaranteed: anyOf: - type: boolean - type: 'null' title: Is Guaranteed description: >- Whether a third party guarantees the payments. Absent when the source does not say. type: object required: - isin - issuer_rp_entity_id title: Bond description: One bond and its terms. ErrorDetail: properties: message: anyOf: - type: string - type: 'null' title: Message type: object title: ErrorDetail Metadata: properties: request_id: type: string title: Request Id timestamp: type: string title: Timestamp type: object required: - request_id title: Metadata Pagination: properties: cursor: anyOf: - type: string - type: 'null' title: Cursor description: Next page token or URL to retrieve the next page of results. examples: - 00000DexaRK4NT6t has_cursor: type: boolean title: Has Cursor description: Whether there are more pages available after this one. default: false examples: - true type: object title: Pagination description: Common pagination response for endpoints that support pagination. IdentifierType: type: string enum: - rp_entity_id title: IdentifierType default: rp_entity_id PaymentFrequency: type: string enum: - annual - semi-annual - quarterly - monthly - at-maturity - irregular title: PaymentFrequency description: How often a bond pays interest. BondRank: type: string enum: - senior - junior-subordinated title: BondRank description: Where a bond ranks for repayment if the issuer cannot pay. BondType: type: string enum: - bond - note - medium-term-note - debenture - covered-bond - certificate-of-deposit - commercial-paper - certificate - structured-product title: BondType description: The kind of debt instrument. securitySchemes: ApiKeyAuth: type: apiKey in: header name: X-API-KEY ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.