> ## Documentation Index > Fetch the complete documentation index at: https://docs.activeviam.com/llms.txt > Use this file to discover all available pages before exploring further. # List bonds for an issuer and market date. > Use this operation after selecting an issuer, currency, and debt type to list bonds outstanding on the market date. `IssuerId`, `Currency`, and `DebtType` must be non-empty; `Other` selects all debt types. Bonds issued after the date, matured before it, or lacking complete convertible definitions are excluded. Provider selection defaults to the caller's organisation. The operation is read-only and synchronous. ## OpenAPI ````yaml /risk-and-pricing/atoti-risk-services/apis-endpoints/openapi/openapi.mintlify.json post /api/Bond/GetBondsForIssuer openapi: 3.0.4 info: title: Derivitec Api 1.0 version: '1.0' servers: - url: https://api.riskportal.activeviam.com security: - oauth2: [] - apikey: [] tags: - name: AdminUser - name: AtotiReport - name: AtotiSession - name: BloombergOAuth - name: Bond - name: BondYieldCurvePage - name: BookAccess - name: Books - name: Commodity - name: Counterparties - name: Currencies - name: Equity - name: EquityDividend - name: EquityPage - name: FeatureFlag - name: Fx - name: FxPage - name: GroupAccess - name: Home - name: LegacyPosition - name: MarketData - name: MarketDataProvider - name: MarketDataProviderAccess - name: Meta - name: Notification - name: Organisation - name: PnLReport - name: PortfolioAccess - name: Portfolios - name: Position - name: PositionFilter - name: PricingEnvironment - name: PricingEnvironmentAccess - name: RateAsset - name: RateAssetPage - name: Report - name: ReportDefinition - name: ReportHistoryLauncherQuery - name: ReportLauncher - name: ReportQuery - name: ReportQueryViewUser - name: ReportRestriction - name: ReportView - name: RiskReport - name: Tradable - name: TradeBooking - name: User - name: VarReport - name: VarReportQuery - name: YieldCurvePage paths: /api/Bond/GetBondsForIssuer: post: tags: - Bond summary: List bonds for an issuer and market date. description: >- Use this operation after selecting an issuer, currency, and debt type to list bonds outstanding on the market date. `IssuerId`, `Currency`, and `DebtType` must be non-empty; `Other` selects all debt types. Bonds issued after the date, matured before it, or lacking complete convertible definitions are excluded. Provider selection defaults to the caller's organisation. The operation is read-only and synchronous. operationId: GetBondsForIssuer requestBody: description: >- Required issuer ID, currency code, debt-type name, date-only `MktDataDate`, and at most one provider selector; the action accepts the default market-date value. content: application/json-patch+json: schema: $ref: '#/components/schemas/ApiGetBondsForIssuerRequest' application/json: schema: $ref: '#/components/schemas/ApiGetBondsForIssuerRequest' text/json: schema: $ref: '#/components/schemas/ApiGetBondsForIssuerRequest' application/*+json: schema: $ref: '#/components/schemas/ApiGetBondsForIssuerRequest' responses: '200': description: >- Returns matching bond IDs, display names, whole years to maturity, and convertible flags, or issuer, currency, debt-type, or missing-data errors. content: application/json: schema: $ref: '#/components/schemas/ApiGetBondsForIssuerResponse' '400': description: BadRequest '401': description: Unauthorized '403': description: Forbidden security: - oauth2: [] - apikey: [] components: schemas: ApiGetBondsForIssuerRequest: required: - $type type: object properties: market_data_environment_name: type: string description: >- Name of the market-data environment to use. Supply either this name or `provider_id`, not both. nullable: true example: Example market data provider_id: type: string description: >- Opaque identifier of the market-data provider to use. Supply either this identifier or `market_data_environment_name`, not both. nullable: true issuer_id: type: string description: Issuer whose bonds are requested. nullable: true currency: type: string description: Currency that narrows the bonds for issuer operation. nullable: true debt_type: type: string description: Debt type used to filter the issuer's bonds. nullable: true mkt_data_date: type: string description: Market date on which bonds for issuer are requested. $type: type: string enum: - >- Derivitec.Web.Core.MarketData.ApiGetBondsForIssuerRequest, Derivitec.Web.Core additionalProperties: false description: Queries an issuer's bonds by market date, currency, and debt type. ApiGetBondsForIssuerResponse: required: - $type type: object properties: is_success: type: boolean description: >- Whether the operation completed successfully. The default is `true`; error outcomes set it to `false`. example: true error_messages: type: array items: type: string description: >- Messages explaining operation-level failures. The collection is empty by default. nullable: true issuer_id: type: string description: Issuer to which the returned bonds belong. nullable: true currency: type: string description: Currency that narrows the bonds for issuer operation. nullable: true debt_type: type: string description: Debt type represented by the returned bonds. nullable: true bonds: type: array items: $ref: '#/components/schemas/BondDetails' description: Bond summaries matching the issuer query. nullable: true $type: type: string enum: - >- Derivitec.Web.Core.MarketData.ApiGetBondsForIssuerResponse, Derivitec.Web.Core additionalProperties: false description: Returns the bonds matching an issuer, currency, and debt-type query. BondDetails: required: - $type type: object properties: id: type: string description: Bond represented by the summary. nullable: true name: type: string description: Display name. nullable: true years_to_mat: type: integer description: Remaining maturity displayed for the bond. format: int32 is_convertible: type: boolean description: Whether the record is marked as convertible. provider_name: type: string description: Data-provider name. nullable: true $type: type: string enum: - Derivitec.Web.Core.MarketData.BondDetails, Derivitec.Web.Core additionalProperties: false description: Compact bond description returned for curve inspection. securitySchemes: oauth2: type: oauth2 description: >- OAuth2 access-token requested from AWS Cognito and provided as a Auth Bearer header flows: implicit: authorizationUrl: https://auth.riskportal.derivitec.com/oauth2/authorize scopes: {} apikey: type: apiKey description: API-Key requested via the site and provided as a header name: x-api-key in: header ````