GraceDB Overview

The Gravitational-Wave Candidate Event Database (GraceDB) is a service operated by the LIGO Scientific Collaboration. It provides a centralized location for aggregating and retrieving information about candidate gravitational-wave events. GraceDB provides an API for programmatic access, and a client package is available for interacting with the API.

Attention LVK Users: As of October 2022, LVAlert has been decomissioned and replaced by igwn-alert. For more information on transitioning your workflows, please consult:
  • The LVAlert to igwn-alert transition guide
  • The igwn-alert User Guide

  • Useful information

  • Information about GW alerts and real-time data products is available in the LIGO/Virgo Public Alert Guide.
  • Real-time status of the LIGO Data Grid.
  • Need help? Send an email to, or LIGO/Virgo users can report issues on the GraceDB Gitlab page.

  • Playground instance

    This GraceDB instance is designed for users to develop and test their own applications. It mimics the production instance in all but the following ways:

    • Phone alerts (calls/SMS) are disabled
    • Email alerts are disabled
    • igwn-alert messages to kafka:// are enabled
      • Messages are sent to group: gracedb-playground
    • Only LIGO logins are provided (no login via InCommon or Google).
    • Events and associated data will not be preserved indefinitely. A nightly cron job removes events older than 21 days.

    Server code version: 2.18.1