Articles in this section

See more

CoMeta API Endpoints and Data Fields

  • Updated

Endpoint and data field descriptions

  • /v1/business-activities
    • Returns business activity ID and name for all CoMeta business activities
    • Fields
      • BusinessActivityId: Unique identification number for a CoMeta business activity. A business activity is the activity engaged in by a company through which it exposes potential plaintiffs to a Litagion agent. The business activity need not be the most proximate source of exposure to the plaintiff.
      • Name: Name of the business activity.
  • /v1/business-activities/{businessActivityId}
    • Returns business activity name for a selected business activity ID
    • Fields
      • BusinessActivityId: Unique identification number for a CoMeta business activity. A business activity is the activity engaged in by a company through which it exposes potential plaintiffs to a Litagion agent. The business activity need not be the most proximate source of exposure to the plaintiff.
      • Name: Name of business activity.
  • /v1/business-activities/litagion/{litagionId}
    • Returns business activity IDs and associated maximum liability risk scores for a selected Litagion ID
    • Fields
      • BusinessActivityId: Unique identification number for a CoMeta business activity. A business activity is the activity engaged in by a company through which it exposes potential plaintiffs to a Litagion agent. The business activity need not be the most proximate source of exposure to the plaintiff.
      • LitagionId: Unique identification number for a CoMeta Litagion agent.
      • MaxLiabilityRisk: The highest liability risk score for a business activity-Litagion agent pair. Liability risk is a qualitative measure of the likelihood that U.S. courts will hold companies engaged in a business activity liable for exposing plaintiffs to a Litagion agent and causing their harm.
  • /v1/business-activities/company/{companyId}
    • Returns business activity IDs, Litagion agent IDs, and associated match qualities for a selected company ID
    • Fields
      • Unique identification number for a CoMeta company.
      • BusinessActivityId: Unique identification number for a CoMeta business activity. A business activity is the activity engaged in by a company through which it exposes potential plaintiffs to a Litagion agent. The business activity need not be the most proximate source of exposure to the plaintiff.
      • LitagionId: Unique identification number for a CoMeta Litagion agent.
      • MatchQuality: A qualitative assessment of Praedicat’s confidence that the company is engaged in a business activity and exposes plaintiffs to a Litagion agent through that activity.
  • /v1/business-activities/company/{companyId}/litagion/{litagionId}
    • Returns business activity IDs and associated match qualities for a selected company ID and Litagion ID
    • Fields
      • Unique identification number for a CoMeta company.
      • BusinessActivityId: Unique identification number for a CoMeta business activity. A business activity is the activity engaged in by a company through which it exposes potential plaintiffs to a Litagion agent. The business activity need not be the most proximate source of exposure to the plaintiff.
      • LitagionId: Unique identification number for a CoMeta Litagion agent.
      • MatchQuality: A qualitative assessment of Praedicat’s confidence that the company is engaged in a business activity and exposes plaintiffs to a Litagion agent through that activity.
  • /v1/companies
    • Returns company ID and name for all CoMeta companies
    • Fields
      • Unique identification number for a CoMeta company.
      • Name: Name of company.
  • /v1/companies/{companyId}
    • Returns company name and parent company status for a selected company ID
    • Fields
      • Unique identification number for a CoMeta company.
      • Name: Name of company.
      • IsGobalUltimateParentCompany: Flag for whether selected company ID represents the global ultimate parent company.
  • /v1/companies/{companyId/ground-up-loss
    • Returns ground-up loss and loss latency for a selected company ID
    • Fields
      • Unique identification number for a CoMeta company.
      • EL: Expected ground-up loss.
      • TVaR5: Average ground-up loss for the top 5% of all loss values.
      • PML5: Ground-up loss corresponding to the 95th percentile of all loss values.
      • PML1: Ground-up loss corresponding to the 99th percentile of all loss values.
      • ELL: Number of years until 50% of expected losses have been incurred.
      • LLTVaR5: Number of years until 50% of TVaR5 losses have been incurred.
      • LL5: Number of years until 50% of PML5 losses have been incurred.
      • LL1: Number of years until 50% of PML1 losses have been incurred.
  • /v1/companies/{companyId/litagion-ground-up-loss
    • Returns ground-up loss for a selected company ID by Litagion agent
    • Fields
      • Unique identification number for a CoMeta company.
      • LitagionId: Unique identification number for a CoMeta Litagion agent.
      • EL: Expected ground-up loss.
      • TVaR5: Average ground-up loss for the top 5% of all loss values.
      • PML5: Ground-up loss corresponding to the 95th percentile of all loss values.
      • PML1: Ground-up loss corresponding to the 99th percentile of all loss values.
  • /v1/companies/{companyId}/litagions
    • Returns Litagion agent IDs, and associated harm counts, maximum general causation risk scores, liability risk scores, and match qualities for a selected company ID
    • Fields
      • CompanyId. Unique identification number for a CoMeta company.
      • CompanyName. Name of company.
      • CoMetaCompanyURL. URL for company profile page (old-style) in CoMeta.
      • LitagionId. Unique identification number for a CoMeta Litagion agent.
      • LitagionName. Name of Litagion agent.
      • CoMetaLitagionURL. URL for Litagion agent profile page in CoMeta.
      • NumberOfHarms. Number of CoMeta harms associated with a CoMeta Litagion agent.
      • MaxGCScore. Highest general causation risk score for a CoMeta Litagion agent. The general causation risk score measures the degree to which scientists accept the hypothesis that a Litagion agent causes a harm. The score ranges between -1 and +1, where -1 indicates scientists reject the hypothesis, +1 indicates scientists accept the hypothesis, and 0 indicates scientists are equivocal.
      • MaxGCScorePct5. Highest general causation risk score at the 95th percentile of the forecast distribution in the last year of the forecast for a CoMeta Litagion agent.
      • MaxLiabilityRisk. The highest liability risk score for a company-Litagion agent pair. Liability risk is a qualitative measure of the likelihood that U.S. courts will hold companies engaged in a business activity liable for exposing plaintiffs to a Litagion agent and causing their harm.
      • MaxMatchQuality. The highest match quality for a company-Litagion agent pair. Match quality provides a qualitative assessment of Praedicat’s confidence that the company is engaged in a business activity and exposes plaintiffs to a Litagion agent through that activity.
  • v1/risk-score/companies/{companyId}
    • Returns company risk score information for a selected company ID
    • Fields
      • CompanyId. Unique identification number for a CoMeta company.
      • PraedicatBusinessName. Name of company.
      • IsGlobalUltimateParent. Flag for whether selected company ID represents the global ultimate parent company.
      • Company risk score. The company risk score ranges from 0 to 100, where zero implies no risk and 100 implies maximum risk.
      • ActivationProbability. Probability litigation is activated against the company given its hazards and business activities.
      • EmergingInterestAgents. Number of emerging interest agents to which the company is exposed.
      • EmergingDamageAgents. Number of emerging damage agents to which the company is exposed.
      • EmergingLitigationAgents. Number of emerging litigation agents to which the company is exposed.
      • EL. Expected ground-up loss.
      • TVaR5. Average ground-up loss for the top 5% of all loss values.
      • PML5. Ground-up loss corresponding to the 95th percentile of all loss values.
      • PML1. Ground-up loss corresponding to the 99th percentile of all loss values.
  • /v1/risk-score/companies/duns/{duns}
    • Returns company risk score information for a selected D-U-N-S Number.
    • Fields
      • CompanyId. Unique identification number for a CoMeta company.
      • PraedicatBusinessName. Name of company.
      • IsGlobalUltimateParent. Flag for whether selected company ID represents the global ultimate parent company.
      • Company risk score. The company risk score ranges from 0 to 100, where zero implies no risk and 100 implies maximum risk.
      • ActivationProbability. Probability litigation is activated against the company given its hazards and business activities.
      • EmergingInterestAgents. Number of emerging interest agents to which the company is exposed.
      • EmergingDamageAgents. Number of emerging damage agents to which the company is exposed.
      • EmergingLitigationAgents. Number of emerging litigation agents to which the company is exposed.
      • EL. Expected ground-up loss.
      • TVaR5. Average ground-up loss for the top 5% of all loss values.
      • PML5. Ground-up loss corresponding to the 95th percentile of all loss values.
      • PML1. Ground-up loss corresponding to the 99th percentile of all loss values.
  •  /v1/harms
    • Returns harm ID and name for all CoMeta harms
    • Fields
      • Unique identification number for a CoMeta harm.
      • Name: Name of harm.
  • /v1/harms/{harmId}
    • Returns harm name and description for a selected harm ID
    • Fields
      • Unique identification number for a CoMeta harm.
      • Name: Name of harm.
      • Description: Description of harm.
  • /v1/industries
    • Returns industry ID and name for all CoMeta industries
    • Fields
      • Unique identification number for a CoMeta industry. Industry IDs beginning with “1” are 2017 NAICS industries. Industry IDs beginning with “2” are SIC industries.
      • Name: Name of industry.
  • /v1/industries{industryId}
    • Returns industry name and description for a selected industry ID
    • Fields
      • Unique identification number for a CoMeta industry. Industry IDs beginning with “1” are 2017 NAICS industries. Industry IDs beginning with “2” are SIC industries.
      • Name: Name of industry.
      • Description: Description of industry.
  • /v1/industries{industryId}/ground-up-loss
    • Returns average ground-up loss within a selected industry ID
    • Fields
      • Unique identification number for a CoMeta industry. Industry IDs beginning with “1” are 2017 NAICS industries. Industry IDs beginning with “2” are SIC industries.
      • EL: Expected ground-up loss
      • TVaR5: Ground-up loss for the top 5% of all loss values.
      • PML5: Ground-up loss corresponding to the 95th percentile of all loss values.
      • PML1: Ground-up loss corresponding to the 99th percentile of all loss values.
  • /v1/industries{industryId}/litagion-ground-up-loss
    • Returns average ground-up loss within a selected industry ID by Litagion agent
    • Fields
      • Unique identification number for a CoMeta industry. Industry IDs beginning with “1” are 2017 NAICS industries. Industry IDs beginning with “2” are SIC industries.
      • LitagionId: Unique identification number for a CoMeta Litagion agent.
      • EL: Expected ground-up loss.
      • TVaR5: Average ground-up loss for the top 5% of all loss values.
      • PML5: Ground-up loss corresponding to the 95th percentile of all loss values.
      • PML1: Ground-up loss corresponding to the 99th percentile of all loss values.
  • /v1/litagions
    • Returns Litagion ID and name for all CoMeta Litagion agents
    • Fields
      • LitagionId: Unique identification number for a CoMeta Litagion agent.
      • Name: Name of Litagion agent.
  • /v1/litagions/{litagionId}
    • Returns Litagion name and description for a selected Litagion ID
    • Fields
      • LitagionId: Unique identification number for a CoMeta Litagion agent.
      • Name: Name of Litagion agent.
      • Description: Description of Litagion agent.
  • /v1/litagions/{litagionId}/risk-scores
    • Returns risk scores for a selected Litagion ID
    • Fields
      • LitagionId: Unique identification number for a CoMeta Litagion agent.
      • OverallRisk: A qualitative measure of the overall risk that a Litagion agent will be the subject of a future mass litigation event.
      • ScienceRisk: A qualitative measure of the level of scientific support that a Litagion agent causes harm.
      • ClashRisk: A qualitative measure of the degree of cross-industry clash that would occur were there to be a mass litigation event.
      • ProjectedLoss: A qualitative measure of the extent of losses incurred by defendants economy-wide were there to be a mass litigation event.
      • ProjectedScienceRisk: A qualitative measure of the degree to which science risk is forecasted to increase in the future.
      • LiabilityRisk: A qualitative measure of the strength of a hypothetical plaintiff’s legal case, without consideration for science risk.
  • /v1/litagions/{litagionId}/gc
    • Returns general causation risk scores for a selected Litagion ID by harm and year
    • Fields
      • LitagionId: Unique identification number for a CoMeta Litagion agent.
      • Unique identification number for a CoMeta harm.
      • Year: The year over which the GCScore is evaluated.
      • GCScore: The general causation risk score. The GCScore measures the degree to which scientists accept the hypothesis that a Litagion agent causes a harm. The score ranges between -1 and +1, where -1 indicates scientists reject the hypothesis, +1 indicates scientists accept the hypothesis, and 0 indicates scientists are equivocal.
  • /v1/litagions/{litagionId}/harm/{harmId}/gc
    • Returns general causation risk scores for a selected Litagion ID and harm ID by year
    • Fields
      • LitagionId: Unique identification number for a CoMeta Litagion agent.
      • Unique identification number for a CoMeta harm.
      • Year: The year over which the GCScore is evaluated.
      • GCScore: The general causation risk score. The GCScore measures the degree to which scientists accept the hypothesis that a Litagion agent causes a harm. The score ranges between -1 and +1, where -1 indicates scientists reject the hypothesis, +1 indicates scientists accept the hypothesis, and 0 indicates scientists are equivocal.
  • /v1/litagions/{litagionId}/gc-by-year/{Year}
    • Returns general causation risk scores for a selected Litagion ID and year by harm
    • Fields
      • LitagionId: Unique identification number for a CoMeta Litagion agent.
      • Unique identification number for a CoMeta harm.
      • Year: The year over which the GCScore is evaluated.
      • GCScore: The general causation risk score. The GCScore measures the degree to which scientists accept the hypothesis that a Litagion agent causes a harm. The score ranges between -1 and +1, where -1 indicates scientists reject the hypothesis, +1 indicates scientists accept the hypothesis, and 0 indicates scientists are equivocal.
  • /v1/litagions/{litagionId}/gc-forecast
    • Returns forecasted general causation risk scores for a selected Litagion ID by harm and forecast year
    • Fields
      • LitagionId: Unique identification number for a CoMeta Litagion agent.
      • Unique identification number for a CoMeta harm.
      • Year: The forecast year over which the GCScore is evaluated.
      • GCScore: The general causation risk score. The GCScore measures the degree to which scientists accept the hypothesis that a Litagion agent causes a harm. The score ranges between -1 and +1, where -1 indicates scientists reject the hypothesis, +1 indicates scientists accept the hypothesis, and 0 indicates scientists are equivocal.
      • Percentile: Forecasted GCScores are reported for the mean (EV) and selected percentiles (1, 5, 10, 50, 90, 95, and 99) of the forecast distribution.
  • /v1/litagions/{litagionId}/harm/{harmId}/gc-forecast
    • Returns forecasted general causation risk scores for a selected Litagion ID and harm ID by forecast year
    • Fields
      • LitagionId: Unique identification number for a CoMeta Litagion agent.
      • Unique identification number for a CoMeta harm.
      • Year: The forecast year over which the GCScore is evaluated.
      • GCScore: The general causation risk score. The GCScore measures the degree to which scientists accept the hypothesis that a Litagion agent causes a harm. The score ranges between -1 and +1, where -1 indicates scientists reject the hypothesis, +1 indicates scientists accept the hypothesis, and 0 indicates scientists are equivocal.
      • Percentile: Forecasted GCScores are reported for the mean (EV) and selected percentiles (1, 5, 10, 50, 90, 95, and 99) of the forecast distribution.
  • /v1/litagions/{litagionId}/gc-forecast-by-year/{Year}
    • Returns forecasted general causation risk scores for a selected Litagion ID and forecast year by harm
    • Fields
      • LitagionId: Unique identification number for a CoMeta Litagion agent.
      • Unique identification number for a CoMeta harm.
      • Year: The forecast year over which the GCScore is evaluated.
      • GCScore: The general causation risk score. The GCScore measures the degree to which scientists accept the hypothesis that a Litagion agent causes a harm. The score ranges between -1 and +1, where -1 indicates scientists reject the hypothesis, +1 indicates scientists accept the hypothesis, and 0 indicates scientists are equivocal.
      • Percentile: Forecasted GCScores are reported for the mean (EV) and selected percentiles (1, 5, 10, 50, 90, 95, and 99) of the forecast distribution.
  • /v1/litagions/{litagionId}/economy-wide-loss
    • Returns economy-wide loss statistics for a selected Litagion ID
    • Fields
      • LitagionId: Unique identification number for a CoMeta Litagion agent.
      • EL: Expected economy-wide loss.
      • TVaR5: Average economy-wide for the top 5% of all loss values.
      • PML5: Economy-wide loss corresponding to the 95th percentile of all loss values.
      • PML1: Economy-wide loss corresponding to the 99th percentile of all loss values.
  • /v1/themes
    • Returns theme ID and name for all CoMeta themes
    • Fields
      • ThemeId: Unique identification number for a CoMeta theme.
      • Name: Name of theme.
  • /v1/themes{themeId}
    • Returns theme name and description for a selected theme ID
    • Fields
      • ThemeId: Unique identification number for a CoMeta theme.
      • Name: Name of theme.
      • Description: Description of theme.
  • /v1/themes/{themeId}/litagions
    • Returns Litagion IDs for a selected theme ID
    • Fields
      • ThemeId: Unique identification number for a CoMeta theme.
      • LitagionId: Unique identification number for a CoMeta Litagion agent.

Related articles