Find Entity
findEntityFull Description
Find entity ID or multiple IDs based on user provided entity names or criteria, including sector, region, size, or rating group.
Parameters (1 required, 1 optional)
datastringgetAlternativesbooleanMoody's GenAI-Ready Data powers AI applications with access to Moody's Ratings proprietary credit ratings, research, and comprehensive entity intelligence. Get streamlined access to high-quality data such as ownership structures, financials, ratings drivers, and scorecards, all structured to optimize a variety of workflows including compliance, credit analysis, M&A, and business development.
findEntityFind entity ID or multiple IDs based on user provided entity names or criteria, including sector, region, size, or rating group.
datastringgetAlternativesbooleangetEntityCountryProfileRetrieve Moody's view on a sovereign entity that a given entity has domicile in using entity ID to:
Note: This tool requires entity ID(s). If the input to this tool does not include entity ID(s), you must first call the findEntity tool to search for and obtain the appropriate entity ID(s).
entitiesarraygetEntityCreditOpinionOutlookRetrieve Outlook section from the latest Moody's Credit Opinion report for a given entity ID to:
Note: This tool requires entity ID(s). If the input to this tool does not include entity ID(s), you must first call the findEntity tool to search for and obtain the appropriate entity ID(s).
entitiesarraygetEntityCreditOpinionSummaryRetrieve rating drivers from Summary sections of Moody's credit opinion report for a given entity ID.
Note: This tool requires entity ID(s). If the input to this tool does not include entity ID(s), you must first call the findEntity tool to search for and obtain the appropriate entity ID(s).
entitiesarraygetEntityCreditUpgradeDowngradeFactorsRetrieve upgrade and downgrade factors from Moody's credit opinion report(s) for the given entity ID(s) to:
Note: This tool requires entity ID(s). If the input to this tool does not include entity ID(s), you must first call the findEntity tool to search for and obtain the appropriate entity ID(s).
entitiesarraygetEntityEsgRetrieve ESG section from Moody's credit opinion report for a given entity ID to:
Note: This tool requires entity ID(s). If the input to this tool does not include entity ID(s), you must first call the findEntity tool to search for and obtain the appropriate entity ID(s).
entitiesarraygetEntityPeersRetrieve peer entities for a given entity ID.
Note: This tool requires entity ID(s). If the input to this tool does not include entity ID(s), you must first call the findEntity tool to search for and obtain the appropriate entity ID(s).
entitiesarraygetAlternativesbooleanmaxPeersPerEntitynumbergetEntityRatingsRetrieve the current Moody's roll-up Long Term Rating and Outlook, along with the ratings history since 2000, for a given entity ID to:
Note: This tool requires entity ID(s). If the input to this tool does not include entity ID(s), you must first call the findEntity tool to search for and obtain the appropriate entity ID(s).
entitiesarrayyearsnumbergetEntityScorecardRetrieve rating methodology and scorecard factors section from Moody's credit opinion report for a given entity ID to:
Note: This tool requires entity ID(s). If the input to this tool does not include entity ID(s), you must first call the findEntity tool to search for and obtain the appropriate entity ID(s).
entitiesarraygetEntitySectorOutlookRetrieve Moody's forward-looking view on a sector that a given entity belongs to using entity ID to:
Note: This tool requires entity ID(s). If the input to this tool does not include entity ID(s), you must first call the findEntity tool to search for and obtain the appropriate entity ID(s).
entitiesarraygetEntitySwotRetrieve credit strengths, Challenges, factors that could lead to upgrade and downgrade sections from Moody's credit opinion report for a given entity ID to:
Note: This tool requires entity ID(s). If the input to this tool does not include entity ID(s), you must first call the findEntity tool to search for and obtain the appropriate entity ID(s).
entitiesarraysearchAllDocumentsSearch across all the Moody's research document types for given keywords
keywordsstringsearchEntityDocumentsSearch all the documents for a given entity
Note: This tool requires entity ID(s). If the input to this tool does not include entity ID(s), you must first call the findEntity tool to search for and obtain the appropriate entity ID(s).
entitiesarrayquerystringsearchEntityEarningsCallSearch for Earnings Call Transcripts on a given entity ID or a query to track key developments and strategic initiatives.
Note: This tool requires entity ID(s). If the input to this tool does not include entity ID(s), you must first call the findEntity tool to search for and obtain the appropriate entity ID(s).
entitiesarrayquerystringsearchNewsSearch for news articles using entity IDs, keywords, or both (at least one required). Track developments, identify trends, and monitor narratives for entities or topics.
Time Period: Specify dateRange (exact dates) or timeRange (preset like past7days). dateRange overrides timeRange. Default: past365days. Time period is helpful when you want to search for news articles that are within a specific time period.
Usage Patterns:
contentTypearraydateRangeobjectentitiesarraymaxResultsPerEntitynumberquerystringrerankResultsbooleansearchTypestringkeywordsemantichybridtimeRangestringtodaypast2dayspast7dayspast30dayspast60dayspast90dayspast180dayspast365days