Skip to main content
GET
/
v1
/
ratings
Search Ratings
curl --request GET \
  --url https://api.example.com/v1/ratings

Documentation Index

Fetch the complete documentation index at: https://docs.debtstack.ai/llms.txt

Use this file to discover all available pages before exploring further.

​
Overview

Search credit rating history across 253 companies. Returns issuer-level and instrument-level ratings from S&P, Moody’s, and Fitch, sourced from SEC Rule 17g-7(b) NRSRO disclosures and LLM extraction from SEC filings.

​
Request

​
Company Filters

​
ticker
string
Filter by company ticker(s), comma-separated.Example: AAPL,MSFT,GOOGL
​
sector
string
Filter by sector.Example: Technology

​
Rating Filters

​
rating_bucket
string
Filter by rating bucket: IG, HY-BB, HY-B, HY-CCC, NR
​
sp_rating
string
Filter by S&P rating (e.g., BB+, BBB-)
​
moodys_rating
string
Filter by Moody’s rating (e.g., Ba1, Baa3)
​
rating_type
string
Filter by rating type: issuer, senior_secured, senior_unsecured, subordinated, corporate_family
​
cusip
string
Filter by instrument CUSIP for instrument-level ratings.
​
issuer_only
boolean
default:"false"
Show only issuer-level ratings (exclude instrument-level).

​
Date Filters

​
from_date
string
Start date (YYYY-MM-DD).
​
to_date
string
End date (YYYY-MM-DD).

​
Convenience

​
latest
boolean
default:"false"
Return only the most recent rating per company/agency.

​
Response Options

​
fields
string
Comma-separated fields to return.Example: ticker,agency,rating,effective_date
​
sort
string
default:"-effective_date"
Sort field. Prefix - for descending.
​
limit
integer
default:"50"
Results per page. Maximum 200.
​
offset
integer
default:"0"
Pagination offset.

​
Coverage

  • 253 companies with at least one rating
  • 607 total ratings across S&P, Moody’s, and Fitch
  • Rating types: issuer, senior_secured, senior_unsecured, subordinated, corporate_family
  • Sources: SEC Rule 17g-7(b) NRSRO disclosures (Fitch, Moody’s) + LLM extraction from SEC filings (S&P)
  • Refresh: Monthly (1st Sunday, 2 AM ET)

​
Examples

​
Get Latest Ratings for a Company

curl "https://api.debtstack.ai/v1/ratings?ticker=AAPL&latest=true" \
  -H "X-API-Key: ds_xxxxx"

​
Response

{
  "ratings": [
    {
      "ticker": "AAPL",
      "company_name": "Apple Inc.",
      "agency": "sp",
      "rating": "AA+",
      "rating_type": "issuer",
      "outlook": "stable",
      "effective_date": "2024-08-15",
      "rating_bucket": "IG",
      "source_section_type": "llm_extraction"
    },
    {
      "ticker": "AAPL",
      "company_name": "Apple Inc.",
      "agency": "moodys",
      "rating": "Aaa",
      "rating_type": "issuer",
      "outlook": "stable",
      "effective_date": "2024-06-20",
      "rating_bucket": "IG",
      "source_section_type": "nrsro_17g7"
    },
    {
      "ticker": "AAPL",
      "company_name": "Apple Inc.",
      "agency": "fitch",
      "rating": "AA+",
      "rating_type": "issuer",
      "outlook": "stable",
      "effective_date": "2024-05-10",
      "rating_bucket": "IG",
      "source_section_type": "nrsro_17g7"
    }
  ],
  "meta": {
    "total": 3,
    "limit": 50,
    "offset": 0
  }
}

​
More Examples

​
Screen for Investment Grade Companies

curl "https://api.debtstack.ai/v1/ratings?rating_bucket=IG&latest=true&issuer_only=true" \
  -H "X-API-Key: ds_xxxxx"

​
Find High-Yield Ratings

curl "https://api.debtstack.ai/v1/ratings?rating_bucket=HY-BB&latest=true" \
  -H "X-API-Key: ds_xxxxx"

​
Compare Ratings Across MAG7

curl "https://api.debtstack.ai/v1/ratings?ticker=AAPL,MSFT,GOOGL,AMZN,NVDA,META,TSLA&latest=true&issuer_only=true" \
  -H "X-API-Key: ds_xxxxx"