Catalysts and litigation

One regulatory event or deadline, with source evidence and revisions.

One row is

One regulatory event or deadline, with source evidence and revisions

Example response

Trimmed real output. No key needed.

GET /v1/datasets/catalysts/sample

Dates reflect the example, not current coverage.

{
  "data": {
    "events": [
      {
        "source": "fda_approvals",
        "agency": "FDA",
        "jurisdiction": "US",
        "country": "US",
        "status": "approved",
        "summary": "Labeling",
        "parties": [
          {
            "name": "CHEPLAPHARM",
            "role": "current application sponsor",
            "entityId": null,
            "ticker": null,
            "exchange": null,
            "resolution": "unresolved",
            "confidence": 0
          }
        ],
        "observedAt": "2026-10-04T01:00:00.000Z",
        "language": "en",
        "confidence": 1,
        "externalId": "NDA020766:SUPPL:22",
        "title": "XENICAL: supplement approval",
        "type": "approval",
        "sourceUrl": "https://www.accessdata.fda.gov/scripts/cder/daf/index.cfm?event=overview.process&ApplNo=020766",
        "sourceDocumentId": "NDA020766",
        "announcedDate": "2007-01-05",
        "effectiveDate": "2007-01-05",
        "datePrecision": {
          "announced": "day",
          "effective": "day"
        },
        "quote": "{\n  \"submission_type\": \"SUPPL\",\n  \"submission_number\": \"22\",\n  \"submission_status\": \"AP\",\n  \"submission_status_date\": \"20070105\",\n  \"review_priority\": \"STANDARD\",\n  \"submission_class_code\": \"LABELING\",\n  \"submission_class_code_description\": \"Labeling\",\n  \"application_docs\": [\n    {\n      \"id\": \"13381\",\n      \"url\": \"http://www.accessdata.fda.gov/drugsatfda_docs/label/2007/020766s022lbl.pdf\",\n      \"date\": \"20070108\",\n      \"type\": \"Label\"\n    },\n    {\n      \"id\": \"25751\",\n      \"url\": \"http://www.accessdata.fda.gov/drugsatfda_docs/appletter/2007/020766s022_ltr.pdf\",\n      \"date\": \"20070112\",\n      \"type\": \"Letter\"\n    }\n  ]\n}",
        "metadata": {
          "extraction": "deterministic source fields",
          "applicationNumber": "NDA020766",
          "attributionBasis": "Current sponsor of the application; not necessarily the historical sponsor on the approval action date",
          "submissionType": "SUPPL",
          "submissionNumber": "22",
          "products": [
            {
              "product_number": "001",
              "reference_drug": "Yes",
              "brand_name": "XENICAL",
              "active_ingredients": [
                {
                  "name": "ORLISTAT",
                  "strength": "120MG"
                }
              ],
              "reference_standard": "Yes",
              "dosage_form": "CAPSULE",
              "route": "ORAL",
              "marketing_status": "Prescription"
            }
          ],
          "reviewPriority": "STANDARD",
          "effectiveDateMeaning": "FDA approval action date"
        },
        "deadlineDate": null,
        "sector": null,
        "quoteOffset": 473,
        "quoteSourceLength": 677,
        "quoteMatchMode": "whitespace",
        "opinion": null,
        "sourcePublishedAt": null,
        "id": "59f68ff9ff738a132e6f1973eef3ba6f",
        "revisionId": "59f68ff9ff738a132e6f1973eef3ba6f:1",
        "revision": 1,
        "changes": [],
        "supersedesRevisionId": null,
        "firstSeenAt": "2026-10-04T01:00:00.000Z",
        "lastSeenAt": "2026-10-04T01:00:00.000Z"
      },
      {
        "source": "fda_approvals",
        "agency": "FDA",
        "jurisdiction": "US",
        "country": "US",
        "status": "approved",
        "summary": "Manufacturing (CMC)",
        "parties": [
          {
            "name": "CHEPLAPHARM",
            "role": "current application sponsor",
            "entityId": null,
            "ticker": null,
            "exchange": null,
            "resolution": "unresolved",
            "confidence": 0
          }
        ],
        "observedAt": "2026-10-04T01:00:00.000Z",
        "language": "en",
        "confidence": 1,
        "externalId": "NDA020766:SUPPL:14",
        "title": "XENICAL: supplement approval",
        "type": "approval",
        "sourceUrl": "https://www.accessdata.fda.gov/scripts/cder/daf/index.cfm?event=overview.process&ApplNo=020766",
        "sourceDocumentId": "NDA020766",
        "announcedDate": "2002-02-27",
        "effectiveDate": "2002-02-27",
        "datePrecision": {
          "announced": "day",
          "effective": "day"
        },
        "quote": "{\n  \"submission_type\": \"SUPPL\",\n  \"submission_number\": \"14\",\n  \"submission_status\": \"AP\",\n  \"submission_status_date\": \"20020227\",\n  \"review_priority\": \"PRIORITY\",\n  \"submission_class_code\": \"MANUF (CMC)\",\n  \"submission_class_code_description\": \"Manufacturing (CMC)\"\n}",
        "metadata": {
          "extraction": "deterministic source fields",
          "applicationNumber": "NDA020766",
          "attributionBasis": "Current sponsor of the application; not necessarily the historical sponsor on the approval action date",
          "submissionType": "SUPPL",
          "submissionNumber": "14",
          "products": [
            {
              "product_number": "001",
              "reference_drug": "Yes",
              "brand_name": "XENICAL",
              "active_ingredients": [
                {
                  "name": "ORLISTAT",
                  "strength": "120MG"
                }
              ],
              "reference_standard": "Yes",
              "dosage_form": "CAPSULE",
              "route": "ORAL",
              "marketing_status": "Prescription"
            }
          ],
          "reviewPriority": "PRIORITY",
          "effectiveDateMeaning": "FDA approval action date"
        },
        "deadlineDate": null,
        "sector": null,
        "quoteOffset": 473,
        "quoteSourceLength": 283,
        "quoteMatchMode": "whitespace",
        "opinion": null,
        "sourcePublishedAt": null,
        "id": "02044c98983fab923ea948fc388055c1",
        "revisionId": "02044c98983fab923ea948fc388055c1:1",
        "revision": 1,
        "changes": [],
        "supersedesRevisionId": null,
        "firstSeenAt": "2026-10-04T01:00:00.000Z",
        "lastSeenAt": "2026-10-04T01:00:00.000Z"
      },
      {
        "source": "fda_approvals",
        "agency": "FDA",
        "jurisdiction": "US",
        "country": "US",
        "status": "approved",
        "summary": "Labeling",
        "parties": [
          {
            "name": "CHEPLAPHARM",
            "role": "current application sponsor",
            "entityId": null,
            "ticker": null,
            "exchange": null,
            "resolution": "unresolved",
            "confidence": 0
          }
        ],
        "observedAt": "2026-10-04T01:00:00.000Z",
        "language": "en",
        "confidence": 1,
        "externalId": "NDA020766:SUPPL:20",
        "title": "XENICAL: supplement approval",
        "type": "approval",
        "sourceUrl": "https://www.accessdata.fda.gov/scripts/cder/daf/index.cfm?event=overview.process&ApplNo=020766",
        "sourceDocumentId": "NDA020766",
        "announcedDate": "2004-07-09",
        "effectiveDate": "2004-07-09",
        "datePrecision": {
          "announced": "day",
          "effective": "day"
        },
        "quote": "{\n  \"submission_type\": \"SUPPL\",\n  \"submission_number\": \"20\",\n  \"submission_status\": \"AP\",\n  \"submission_status_date\": \"20040709\",\n  \"review_priority\": \"STANDARD\",\n  \"submission_class_code\": \"LABELING\",\n  \"submission_class_code_description\": \"Labeling\",\n  \"application_docs\": [\n    {\n      \"id\": \"13380\",\n      \"url\": \"http://www.accessdata.fda.gov/drugsatfda_docs/label/2004/20766slr020_xenical_lbl.pdf\",\n      \"date\": \"20040714\",\n      \"type\": \"Label\"\n    },\n    {\n      \"id\": \"25749\",\n      \"url\": \"http://www.accessdata.fda.gov/drugsatfda_docs/appletter/2004/20766slr020ltr.pdf\",\n      \"date\": \"20040714\",\n      \"type\": \"Letter\"\n    }\n  ]\n}",
        "metadata": {
          "extraction": "deterministic source fields",
          "applicationNumber": "NDA020766",
          "attributionBasis": "Current sponsor of the application; not necessarily the historical sponsor on the approval action date",
          "submissionType": "SUPPL",
          "submissionNumber": "20",
          "products": [
            {
              "product_number": "001",
              "reference_drug": "Yes",
              "brand_name": "XENICAL",
              "active_ingredients": [
                {
                  "name": "ORLISTAT",
                  "strength": "120MG"
                }
              ],
              "reference_standard": "Yes",
              "dosage_form": "CAPSULE",
              "route": "ORAL",
              "marketing_status": "Prescription"
            }
          ],
          "reviewPriority": "STANDARD",
          "effectiveDateMeaning": "FDA approval action date"
        },
        "deadlineDate": null,
        "sector": null,
        "quoteOffset": 473,
        "quoteSourceLength": 687,
        "quoteMatchMode": "whitespace",
        "opinion": null,
        "sourcePublishedAt": null,
        "id": "ab3aa09543d47856ba51f901b8a67aa5",
        "revisionId": "ab3aa09543d47856ba51f901b8a67aa5:1",
        "revision": 1,
        "changes": [],
        "supersedesRevisionId": null,
        "firstSeenAt": "2026-10-04T01:00:00.000Z",
        "lastSeenAt": "2026-10-04T01:00:00.000Z"
      },
      {
        "source": "fda_approvals",
        "agency": "FDA",
        "jurisdiction": "US",
        "country": "US",
        "status": "approved",
        "summary": "Manufacturing (CMC)",
        "parties": [
          {
            "name": "CHEPLAPHARM",
            "role": "current application sponsor",
            "entityId": null,
            "ticker": null,
            "exchange": null,
            "resolution": "unresolved",
            "confidence": 0
          }
        ],
        "observedAt": "2026-10-04T01:00:00.000Z",
        "language": "en",
        "confidence": 1,
        "externalId": "NDA020766:SUPPL:12",
        "title": "XENICAL: supplement approval",
        "type": "approval",
        "sourceUrl": "https://www.accessdata.fda.gov/scripts/cder/daf/index.cfm?event=overview.process&ApplNo=020766",
        "sourceDocumentId": "NDA020766",
        "announcedDate": "2002-02-21",
        "effectiveDate": "2002-02-21",
        "datePrecision": {
          "announced": "day",
          "effective": "day"
        },
        "quote": "{\n  \"submission_type\": \"SUPPL\",\n  \"submission_number\": \"12\",\n  \"submission_status\": \"AP\",\n  \"submission_status_date\": \"20020221\",\n  \"review_priority\": \"PRIORITY\",\n  \"submission_class_code\": \"MANUF (CMC)\",\n  \"submission_class_code_description\": \"Manufacturing (CMC)\"\n}",
        "metadata": {
          "extraction": "deterministic source fields",
          "applicationNumber": "NDA020766",
          "attributionBasis": "Current sponsor of the application; not necessarily the historical sponsor on the approval action date",
          "submissionType": "SUPPL",
          "submissionNumber": "12",
          "products": [
            {
              "product_number": "001",
              "reference_drug": "Yes",
              "brand_name": "XENICAL",
              "active_ingredients": [
                {
                  "name": "ORLISTAT",
                  "strength": "120MG"
                }
              ],
              "reference_standard": "Yes",
              "dosage_form": "CAPSULE",
              "route": "ORAL",
              "marketing_status": "Prescription"
            }
          ],
          "reviewPriority": "PRIORITY",
          "effectiveDateMeaning": "FDA approval action date"
        },
        "deadlineDate": null,
        "sector": null,
        "quoteOffset": 473,
        "quoteSourceLength": 283,
        "quoteMatchMode": "whitespace",
        "opinion": null,
        "sourcePublishedAt": null,
        "id": "52925edc278dccae12b8f91fe3141d81",
        "revisionId": "52925edc278dccae12b8f91fe3141d81:1",
        "revision": 1,
        "changes": [],
        "supersedesRevisionId": null,
        "firstSeenAt": "2026-10-04T01:00:00.000Z",
        "lastSeenAt": "2026-10-04T01:00:00.000Z"
      },
      {
        "source": "fda_approvals",
        "agency": "FDA",
        "jurisdiction": "US",
        "country": "US",
        "status": "approved",
        "summary": "Manufacturing (CMC)",
        "parties": [
          {
            "name": "CHEPLAPHARM",
            "role": "current application sponsor",
            "entityId": null,
            "ticker": null,
            "exchange": null,
            "resolution": "unresolved",
            "confidence": 0
          }
        ],
        "observedAt": "2026-10-04T01:00:00.000Z",
        "language": "en",
        "confidence": 1,
        "externalId": "NDA020766:SUPPL:10",
        "title": "XENICAL: supplement approval",
        "type": "approval",
        "sourceUrl": "https://www.accessdata.fda.gov/scripts/cder/daf/index.cfm?event=overview.process&ApplNo=020766",
        "sourceDocumentId": "NDA020766",
        "announcedDate": "2001-12-19",
        "effectiveDate": "2001-12-19",
        "datePrecision": {
          "announced": "day",
          "effective": "day"
        },
        "quote": "{\n  \"submission_type\": \"SUPPL\",\n  \"submission_number\": \"10\",\n  \"submission_status\": \"AP\",\n  \"submission_status_date\": \"20011219\",\n  \"review_priority\": \"PRIORITY\",\n  \"submission_class_code\": \"MANUF (CMC)\",\n  \"submission_class_code_description\": \"Manufacturing (CMC)\"\n}",
        "metadata": {
          "extraction": "deterministic source fields",
          "applicationNumber": "NDA020766",
          "attributionBasis": "Current sponsor of the application; not necessarily the historical sponsor on the approval action date",
          "submissionType": "SUPPL",
          "submissionNumber": "10",
          "products": [
            {
              "product_number": "001",
              "reference_drug": "Yes",
              "brand_name": "XENICAL",
              "active_ingredients": [
                {
                  "name": "ORLISTAT",
                  "strength": "120MG"
                }
              ],
              "reference_standard": "Yes",
              "dosage_form": "CAPSULE",
              "route": "ORAL",
              "marketing_status": "Prescription"
            }
          ],
          "reviewPriority": "PRIORITY",
          "effectiveDateMeaning": "FDA approval action date"
        },
        "deadlineDate": null,
        "sector": null,
        "quoteOffset": 473,
        "quoteSourceLength": 283,
        "quoteMatchMode": "whitespace",
        "opinion": null,
        "sourcePublishedAt": null,
        "id": "4508390e7af8a92cebb1fc1fbb9916c3",
        "revisionId": "4508390e7af8a92cebb1fc1fbb9916c3:1",
        "revision": 1,
        "changes": [],
        "supersedesRevisionId": null,
        "firstSeenAt": "2026-10-04T01:00:00.000Z",
        "lastSeenAt": "2026-10-04T01:00:00.000Z"
      }
    ],
    "total": 5,
    "limit": 100,
    "offset": 0,
    "asOf": "2026-10-04T01:00:00.000Z",
    "filters": {
      "limit": 100
    },
    "coverage": {
      "totalEvents": 8,
      "linkedEvents": 0,
      "unresolvedParties": 0,
      "jurisdictions": [
        "US"
      ],
      "firstObservedAt": "2026-10-04T01:00:00.000Z",
      "lastObservedAt": "2026-10-04T01:00:00.000Z",
      "sources": []
    },
    "facets": {
      "types": [],
      "agencies": [],
      "countries": [],
      "sectors": [],
      "statuses": []
    },
    "access": {
      "pro": true,
      "lockedRows": 0,
      "previewLimit": 3
    }
  },
  "meta": {
    "dataset": "catalysts",
    "asOf": "2026-10-04T01:00:00.000Z",
    "source": [
      {
        "id": "government-catalysts",
        "attribution": "Government and regulatory publications",
        "licence": "Use subject to Gloom Datasets terms"
      }
    ],
    "historyStarts": "2026-10-04T01:00:00.000Z",
    "coverage": {
      "totalEvents": 8,
      "linkedEvents": 0,
      "jurisdictions": [
        "US"
      ]
    },
    "lastUpdated": "2026-10-04T01:00:00.000Z"
  }
}

Routes

Base URL https://api.gloom.sh. Send a key with each call; the key's account needs a plan.

GET /v1/catalysts2 credits

Government-sourced catalysts and deadlines. Reads the existing dataset service and needs a key on an account with a plan; every plan reads every live dataset in full. Cached market reads can refresh their source data. Unknown, empty and repeated parameters are rejected. History and coverage metadata are null when the stored service cannot establish them.

Parameters16 rows
Parameter

symbol

In

query

Type

string ^[A-Za-z0-9.:-]{1,32}$

Notes

Company symbol; normalized to uppercase.

Parameter

agency

In

query

Type

string

Parameter

country

In

query

Type

string

Parameter

sector

In

query

Type

string

Parameter

status

In

query

Type

string

Parameter

source

In

query

Type

string

Parameter

search

In

query

Type

string

Parameter

from

In

query

Type

date, YYYY-MM-DD

Notes

Valid calendar date (YYYY-MM-DD). from must be on or before to.

Parameter

to

In

query

Type

date, YYYY-MM-DD

Notes

Valid calendar date (YYYY-MM-DD). from must be on or before to.

Parameter

limit

In

query

Type

integer 1 to 200

Parameter

offset

In

query

Type

integer 0 to 500000

Parameter

type

In

query

Type

regulatory, clinical, litigation, antitrust, recall, sanctions, export_control, tariff, rulemaking, approval, advisory, advisory-meeting, pdufa

Parameter

dateField

In

query

Type

announced, effective, deadline, any, observed

Parameter

upcoming

In

query

Type

boolean

Parameter

changed

In

query

Type

boolean

Parameter

litigation

In

query

Type

boolean

  • Credits: 2 (search x1)
  • Plans: Basic, Desk, Enterprise
GET /v1/litigation/{symbol}2 credits

Company litigation and regulatory events. Reads the existing dataset service and needs a key on an account with a plan; every plan reads every live dataset in full. Cached market reads can refresh their source data. Unknown, empty and repeated parameters are rejected. History and coverage metadata are null when the stored service cannot establish them.

Parameter

symbol

In

path, required

Type

string ^[A-Za-z0-9.:-]{1,32}$

Notes

Company symbol; normalized to uppercase.

Parameter

limit

In

query

Type

integer 1 to 200

Parameter

offset

In

query

Type

integer 0 to 500000

  • Credits: 2 (search x1)
  • Plans: Basic, Desk, Enterprise
GET /v1/catalysts/events/{id}5 credits

Catalyst evidence and revisions. Reads the existing dataset service and needs a key on an account with a plan; every plan reads every live dataset in full. Cached market reads can refresh their source data. Unknown, empty and repeated parameters are rejected. History and coverage metadata are null when the stored service cannot establish them.

Parameter

id

In

path, required

Type

string

Parameter

limit

In

query

Type

integer 1 to 200

Parameter

offset

In

query

Type

integer 0 to 500000

  • Credits: 5 (evidence x1)
  • Plans: Basic, Desk, Enterprise
GET /v1/catalysts/changes1 credits

Observed catalyst revisions. Reads the existing dataset service and needs a key on an account with a plan; every plan reads every live dataset in full. Cached market reads can refresh their source data. Unknown, empty and repeated parameters are rejected. History and coverage metadata are null when the stored service cannot establish them.

Parameter

cursor

In

query

Type

string ^\d{1,19}$

Parameter

limit

In

query

Type

integer 1 to 200

Parameter

since

In

query, required

Type

string ^\d{4}-\d{2}-\d{2}T(?:[01]\d|2[0-3]):[0-5]\d:[0-5]\d(?:\.\d{1,6})?(?:Z|[+-](?:[01]\d|2[0-3]):[0-5]\d)$

  • Credits: 1 (change x1)
  • Plans: Basic, Desk, Enterprise

Meta fields

Field

dataset

Here

The dataset id

In the example

"catalysts"

Field

asOf

Here

The observation date established by the service; otherwise null

In the example

"2026-10-04T01:00:00.000Z"

Field

source

Here

Attribution and usage terms of each source

In the example

1 source

Field

historyStarts

Here

Earliest stored history when established by the service; otherwise null.

In the example

"2026-10-04T01:00:00.000Z"

Field

coverage

Here

Service-established coverage; null when unavailable.

In the example

{"totalEvents":8,"linkedEvents":0,"jurisdictions":["US"]}

Field

lastUpdated

Here

The source update time established by the service; otherwise null

In the example

"2026-10-04T01:00:00.000Z"

Sources

Source

Government and regulatory publications

Usage terms

Use subject to Gloom Datasets terms

Errors

These routes can answer 400, 401, 402, 403, 404, 429, 503. See Errors for the codes.

Gloom Datasets reads stored data only: a call never starts a collection.