> ## 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. # Retrieve bond yield curves for market dates. > Use this operation to retrieve issuer yield curves identified by issuer, ISO currency, debt seniority, and optional bond identifier. Maturities are returned as day offsets with dimensionless discount factors. Results use the selected provider and caller organisation; `FallbackOnDerivitecData` defaults to false and, when true, also permits shared Derivitec curves. Unknown issuers and unavailable curve/date combinations are reported while other curves can still be returned. ## OpenAPI ````yaml /risk-and-pricing/atoti-risk-services/apis-endpoints/openapi/openapi.mintlify.json post /api/MarketData/GetBondYieldCurves 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/MarketData/GetBondYieldCurves: post: tags: - MarketData summary: Retrieve bond yield curves for market dates. description: >- Use this operation to retrieve issuer yield curves identified by issuer, ISO currency, debt seniority, and optional bond identifier. Maturities are returned as day offsets with dimensionless discount factors. Results use the selected provider and caller organisation; `FallbackOnDerivitecData` defaults to false and, when true, also permits shared Derivitec curves. Unknown issuers and unavailable curve/date combinations are reported while other curves can still be returned. operationId: GetBondYieldCurves requestBody: description: >- The query payload. `BondYieldCurveIds` and date-only `MarketDates` must be non-empty. Provide either `ProviderId` or `MarketDataEnvironmentName`, not both; omitting both selects the caller's organisation scope. content: application/json-patch+json: schema: $ref: '#/components/schemas/ApiGetBondYieldCurvesRequest' application/json: schema: $ref: '#/components/schemas/ApiGetBondYieldCurvesRequest' text/json: schema: $ref: '#/components/schemas/ApiGetBondYieldCurvesRequest' application/*+json: schema: $ref: '#/components/schemas/ApiGetBondYieldCurvesRequest' responses: '200': description: >- Returns available bond yield curves and errors for invalid provider scope, unknown issuers, or unavailable curves on requested dates. content: application/json: schema: $ref: '#/components/schemas/ApiGetBondYieldCurvesResponse' '400': description: BadRequest '401': description: Unauthorized '403': description: Forbidden security: - oauth2: [] - apikey: [] components: schemas: ApiGetBondYieldCurvesRequest: 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 bond_yield_curve_ids: type: array items: $ref: '#/components/schemas/BondYieldCurveId' description: Bond yield curve IDs selecting the requested bond yield curves. nullable: true market_dates: type: array items: type: string format: date-time description: Market dates on which bond yield curves are requested. nullable: true fallback_on_derivitec_data: type: boolean description: >- Whether the lookup may fall back to the alternative Derivitec data source. $type: type: string enum: - >- Derivitec.Web.Core.MarketData.ApiGetBondYieldCurvesRequest, Derivitec.Web.Core additionalProperties: false description: >- Queries selected bond yield curves across market dates, with an optional shared-data fallback. ApiGetBondYieldCurvesResponse: 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 bond_yield_curves: type: array items: $ref: '#/components/schemas/BondYieldCurve' description: Issuer bond yield curves returned by the query. nullable: true $type: type: string enum: - >- Derivitec.Web.Core.MarketData.ApiGetBondYieldCurvesResponse, Derivitec.Web.Core additionalProperties: false description: Returns issuer bond yield curves and query errors. BondYieldCurveId: required: - $type type: object properties: currency: type: string description: Currency component of the curve key. nullable: true issuer: type: string description: Issuer component of the curve key. nullable: true seniority: enum: - senior - super_senior - other - subordinated - junior_subordinated - preference_shares - senior_loss_absorbing type: string description: Contract or debt seniority classification. bond_identifier: $ref: '#/components/schemas/InstrumentIdentifier' $type: type: string enum: - Derivitec.Web.Core.MarketData.BondYieldCurveId, Derivitec.Web.Core additionalProperties: false description: Business key for an issuer bond curve. BondYieldCurve: required: - $type type: object properties: provider_id: type: string description: >- Market-data provider code recorded as the source of the contribution. Defaults to Derivitec. nullable: true derivitec_created: type: string description: Timestamp at which the market-data record was created. derivitec_modified: type: string description: Optional timestamp of the record's latest modification. nullable: true uploaded_date_time: type: string description: >- Optional timestamp at which the contribution was uploaded. UploadRateAssets ignores the supplied value on each rate asset and stores the current UTC time. nullable: true derivitec_modified_by: type: string description: >- Principal recorded as the latest modifier. UploadRateAssets ignores the supplied value on each rate asset and stores the authenticated user identifier. nullable: true uploaded_by: type: string description: >- Principal recorded as the uploader. UploadRateAssets ignores the supplied value on each rate asset and stores the authenticated user identifier. nullable: true rolled: type: boolean description: Whether the contribution has been rolled. example: false currency: type: string description: Currency dimension of the issuer curve. nullable: true seniority: enum: - senior - super_senior - other - subordinated - junior_subordinated - preference_shares - senior_loss_absorbing type: string description: Contract or debt seniority classification. discount_factors: type: array items: type: number format: double description: Dimensionless curve factors paired by index with Maturities. nullable: true extrapolate: type: boolean description: >- Whether the curve may be evaluated beyond its supplied maturities; initialized to true. issuer_id: type: string description: Issuer selector. nullable: true issuer_identifier: $ref: '#/components/schemas/IssuerIdentifier' maturities: type: array items: type: integer format: int32 description: >- Maturities expressed as day offsets and paired by index with DiscountFactors. nullable: true reference_bond_yield_curve: $ref: '#/components/schemas/BondYieldCurve' reference_date: type: string description: Date to which the data applies. format: date-time bond_identifier: $ref: '#/components/schemas/InstrumentIdentifier' $type: type: string enum: - Derivitec.Web.Core.MarketData.BondYieldCurve, Derivitec.Web.Core additionalProperties: false description: >- Issuer bond curve represented by day-offset maturities and dimensionless discount factors, with optional reference-curve linkage. InstrumentIdentifier: description: >- Instrument code qualified by an identifier namespace and optional market code. discriminator: propertyName: $type mapping: Derivitec.Web.Core.MarketData.InstrumentIdentifier, Derivitec.Web.Core: '#/components/schemas/InstrumentIdentifierMintlifyShape' Derivitec.Web.Core.MarketData.InstrumentInfo, Derivitec.Web.Core: '#/components/schemas/InstrumentInfo' oneOf: - $ref: '#/components/schemas/InstrumentIdentifierMintlifyShape' - $ref: '#/components/schemas/InstrumentInfo' IssuerIdentifier: required: - $type type: object properties: code: type: string description: Issuer code interpreted in the selected issuer namespace. nullable: true identifier_type: enum: - DerivitecBondIssuerId - ReutersOrgId - ShortName - Lei - RedCode - MarkitTicker - ReutersIssuerId - CBondsIssuerId - PermId - BloombergCompanyId - NotSet type: string description: Namespace that determines how the issuer code is interpreted. $type: type: string enum: - Derivitec.Web.Core.MarketData.IssuerIdentifier, Derivitec.Web.Core additionalProperties: false description: Issuer code qualified by an issuer-identifier namespace. InstrumentIdentifierMintlifyShape: required: - $type type: object properties: code: type: string description: Instrument code interpreted in the selected identifier namespace. nullable: true identifier_type: enum: - Derivitec - Ric - Bloomberg - Isin - Figi - Sedol - RedCode - RedPairCode - BloombergYellow - XIgniteCode - CBondsId - EdiSecId - EdiSymbol - Cusip - NotSet type: string description: Namespace that determines how the instrument code is interpreted. market_identification_code: type: string description: >- Optional market identification code that further qualifies the instrument code. nullable: true $type: type: string enum: - >- Derivitec.Web.Core.MarketData.InstrumentIdentifier, Derivitec.Web.Core additionalProperties: false description: >- Instrument code qualified by an identifier namespace and optional market code. InstrumentInfo: required: - $type type: object properties: code: type: string description: Instrument code interpreted in the selected identifier namespace. nullable: true identifier_type: enum: - Derivitec - Ric - Bloomberg - Isin - Figi - Sedol - RedCode - RedPairCode - BloombergYellow - XIgniteCode - CBondsId - EdiSecId - EdiSymbol - Cusip - NotSet type: string description: Namespace that determines how the instrument code is interpreted. market_identification_code: type: string description: >- Optional market identification code that further qualifies the instrument code. nullable: true name: type: string description: Human-readable name of the identified instrument. nullable: true $type: type: string enum: - Derivitec.Web.Core.MarketData.InstrumentInfo, Derivitec.Web.Core additionalProperties: false description: Instrument identifier with a human-readable instrument name. 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 ````