> ## Documentation Index
> Fetch the complete documentation index at: https://docs.coverbase.com/llms.txt
> Use this file to discover all available pages before exploring further.
# Moody's
> Bring Moody's long-term credit ratings for your portfolio into Coverbase: each vendor's rating is recorded, and a downgrade becomes a Radar signal.
For AI agents: a documentation index is available at [https://docs.coverbase.com/llms.txt](https://docs.coverbase.com/llms.txt). This page is also available in markdown by appending .md to the URL.
The Moody's connector is a licensed rating connector: you bring your own Moody's subscription, and Coverbase reads your portfolio with your credentials. It works like the [Black Kite integration](/user-guides/black-kite-monitoring). Ratings land on the vendor's **Certificates** tab under **Licensed Ratings**, and changes become [Radar](/products/supplier-radar) signals.
If a Moody's response does not have the shape Coverbase expects, the pull stops and the panel shows **The last sync failed** with the reason, instead of reading the response as an empty portfolio.
## What it does
* **Provisions monitoring once.** The first time you save credentials, Coverbase adds one Moody's source to Radar and one detector on it, named for a credit rating drop. Both are created once. Archiving the source stops monitoring, and saving new credentials later does not bring it back.
* **Matches companies to vendors.** Each company in your portfolio is matched to a vendor by a match recorded on an earlier pull, then by its domain (walking up to the parent domain, never down), then by its exact legal name. A company that matches no vendor is skipped.
* **Records the rating.** Each pull records the matched vendor's long-term credit rating, from Aaa (best) to C, one notch per step.
* **Signals only on change.** A Radar item is raised only when a stored rating moved. The first pull is a baseline, so connecting a provider does not flood Radar.
## The detector
The detector starts enabled, alerting on a drop of 2 notches or more between pulls. Edit it like any other Radar detector. It has three gates, and at least one must be set. A rating change alerts only when it passes every gate that is set. **Minimum drop** and **Alert below** take zero or more, in the provider's own units.
| Gate | Passes when |
| - | - |
| Minimum drop | The rating fell by at least this much since the last pull. |
| Alert below | The rating is below this value. |
| Grade worsened | The provider's grade or band got worse. |
Alerts go through the ordinary Radar path, so reassessment triggers and monitoring plan signal rules see them like any other signal.
## Authentication
Moody's uses OAuth 2.0 client credentials at `https://api.moodys.com/oauth2/token`. Coverbase reads your portfolio entities from `/entity-risk/v1/portfolio/entities`.
1. Ask Moody's for API client credentials with access to your entity portfolio.
2. Add the vendors you want monitored to that portfolio.
## Set up in Coverbase
1. Open **Configuration → External Integrations** and click **Moody's Analytics**.
2. Enter **Client ID**, **Client Secret**. The panel notes: "Saving the credentials adds a Moody's source to Radar for credit rating changes."
3. Click **Save**, then **Test connection**.
4. Open **Radar** to find the new source and its detector.
The panel never shows a stored secret again. **Remove** deletes the stored credentials; ratings already pulled stay.
## Related
Where licensed ratings show on a vendor.
Triaging the signals a rating change raises.
Letting a rating drop pull monitoring forward.
Coverbase's own outside-in rating, which needs no subscription.
This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.