> ## 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 CDS observations by issuer. > Use this operation to retrieve CDS observations for requested issuer identifiers over an inclusive date range from one authorised provider. Returned records include tenor, seniority, document clause, currency, close, spread, upfront points, running coupon, assumed recovery, and optional price/liquidity fields where available. `TradedSpread` and `RunningCoupon` are basis-point values, `PtsUpfront` is in percentage points, and `AssumedRecovery` is a decimal fraction. Unsupported issuers or issuers without observations are reported without suppressing other data. The operation is read-only. ## OpenAPI ````yaml /risk-and-pricing/atoti-risk-services/apis-endpoints/openapi/openapi.mintlify.json post /api/MarketData/GetCdsData 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/GetCdsData: post: tags: - MarketData summary: Retrieve CDS observations by issuer. description: >- Use this operation to retrieve CDS observations for requested issuer identifiers over an inclusive date range from one authorised provider. Returned records include tenor, seniority, document clause, currency, close, spread, upfront points, running coupon, assumed recovery, and optional price/liquidity fields where available. `TradedSpread` and `RunningCoupon` are basis-point values, `PtsUpfront` is in percentage points, and `AssumedRecovery` is a decimal fraction. Unsupported issuers or issuers without observations are reported without suppressing other data. The operation is read-only. operationId: GetCdsData requestBody: description: >- The query payload. `Identifiers` must be non-empty issuer identifiers in a supported namespace, `StartDate` and `EndDate` are date-only inclusive boundaries, and provider or environment fields select the source. content: application/json-patch+json: schema: $ref: '#/components/schemas/ApiGetCdsDataRequest' application/json: schema: $ref: '#/components/schemas/ApiGetCdsDataRequest' text/json: schema: $ref: '#/components/schemas/ApiGetCdsDataRequest' application/*+json: schema: $ref: '#/components/schemas/ApiGetCdsDataRequest' responses: '200': description: >- Returns available CDS observations grouped by input issuer identifier and errors for invalid provider scope, unsupported issuers, or missing data. content: application/json: schema: $ref: '#/components/schemas/ApiGetCdsDataResponse' '400': description: BadRequest '401': description: Unauthorized '403': description: Forbidden security: - oauth2: [] - apikey: [] components: schemas: ApiGetCdsDataRequest: 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 identifiers: type: array items: $ref: '#/components/schemas/IssuerIdentifier' description: Issuer selectors whose CDS observations are requested. nullable: true start_date: type: string description: Inclusive lower date-only boundary for the requested observations. format: date-time end_date: type: string description: Inclusive upper date-only boundary for the requested observations. format: date-time $type: type: string enum: - >- Derivitec.Web.Core.MarketData.ApiGetCdsDataRequest, Derivitec.Web.Core additionalProperties: false description: Queries dated CDS observations by issuer selector and date range. ApiGetCdsDataResponse: 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 cds_data: type: array items: $ref: '#/components/schemas/IssuerIdentifierCdsDataIListKeyValuePair' description: CDS observations returned for the requested issuers. nullable: true $type: type: string enum: - >- Derivitec.Web.Core.MarketData.ApiGetCdsDataResponse, Derivitec.Web.Core additionalProperties: false description: Returns dated CDS observations for the selected issuers. 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. IssuerIdentifierCdsDataIListKeyValuePair: type: object properties: key: $ref: '#/components/schemas/IssuerIdentifier' value: type: array items: $ref: '#/components/schemas/CdsData' nullable: true additionalProperties: false CdsData: 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 cds_id: type: string description: CDS contract represented by the observation. nullable: true issuer_identifier: $ref: '#/components/schemas/IssuerIdentifier' issuer_id: type: string description: Issuer selector. nullable: true seniority: type: string description: Contract or debt seniority classification. nullable: true doc_clause: type: string description: Documentation clause of the CDS contract. nullable: true tenor: type: string description: Contract tenor. nullable: true readOnly: true close: type: number description: Closing observation. format: double traded_spread: type: number description: Traded spread of the CDS quote, expressed in basis points. format: double pts_upfront: type: number description: Upfront component of the CDS quote, expressed in percentage points. format: double currency: type: string description: Currency of the CDS contract represented by the observation. nullable: true date: type: string description: Observation date. high: type: number description: Highest observation. format: double nullable: true low: type: number description: Lowest observation. format: double nullable: true open: type: number description: Opening observation. format: double nullable: true contributor: type: string description: Source contributor label carried with the observation. nullable: true running_coupon: type: number description: >- Running coupon used with the CDS spread quote, expressed in basis points. format: double assumed_recovery: type: number description: >- Recovery assumption used with the CDS spread quote, expressed as a decimal fraction. format: double liquidity_score: type: integer description: Liquidity score carried with the observation. format: int32 nullable: true $type: type: string enum: - Derivitec.Web.Core.MarketData.CdsData, Derivitec.Web.Core additionalProperties: false description: >- Dated CDS trading observation with issuer, contract, quotation, contributor, and liquidity context. 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 ````