Return all event versions

Query Parameters

  • name-contains=<string>
  • release=<cat1>[,<cat2>]
  • min-<param-name>=<value>
  • max-<param-name>=<value>
  • lastver=false
  • include-default-parameters: if true or empty, include a list with the preferred values for default parameters.

Find the full list of allowed parameter <param-name>s in the /default-parameters/ endpoint.

Example:

/event-versions?max-mass-1-source=3

GET /api/v2/event-versions?format=api&include-default-parameters=true&max-mass-1-source=3
HTTP 200 OK
Allow: GET, HEAD, OPTIONS
Content-Type: application/json
Vary: Accept

{
    "next": null,
    "previous": null,
    "results_count": 4,
    "results_per_page": 20,
    "num_pages": 1,
    "page_number": 1,
    "results": [
        {
            "name": "GW190425",
            "shortName": "GW190425-v1",
            "gps": 1240215503.0,
            "version": 1,
            "catalog": "O3_Discovery_Papers",
            "detectors": [
                "H1",
                "L1",
                "V1"
            ],
            "detail_url": "https://gwosc.org/api/v2/event-versions/GW190425-v1?format=api",
            "default_parameters": [
                {
                    "name": "chirp_mass",
                    "unit": "M_sun",
                    "description": "na",
                    "best": 1.4868,
                    "upper_error": 0.0003,
                    "lower_error": -0.0003,
                    "is_upper_limit": false,
                    "is_lower_limit": false
                },
                {
                    "name": "chirp_mass_source",
                    "unit": "M_sun",
                    "description": "na",
                    "best": 1.44,
                    "upper_error": 0.02,
                    "lower_error": -0.02,
                    "is_upper_limit": false,
                    "is_lower_limit": false
                },
                {
                    "name": "chi_eff",
                    "unit": "",
                    "description": "na",
                    "best": 0.012,
                    "upper_error": 0.015,
                    "lower_error": -0.013,
                    "is_upper_limit": false,
                    "is_lower_limit": false
                },
                {
                    "name": "luminosity_distance",
                    "unit": "Mpc",
                    "description": "na",
                    "best": 159.0,
                    "upper_error": 69.0,
                    "lower_error": -72.0,
                    "is_upper_limit": false,
                    "is_lower_limit": false
                },
                {
                    "name": "mass_1_source",
                    "unit": "M_sun",
                    "description": "na",
                    "best": 1.74,
                    "upper_error": 0.17,
                    "lower_error": -0.09,
                    "is_upper_limit": false,
                    "is_lower_limit": false
                },
                {
                    "name": "mass_2_source",
                    "unit": "M_sun",
                    "description": "na",
                    "best": 1.56,
                    "upper_error": 0.08,
                    "lower_error": -0.14,
                    "is_upper_limit": false,
                    "is_lower_limit": false
                },
                {
                    "name": "network_matched_filter_snr",
                    "unit": "",
                    "description": "na",
                    "best": 12.46,
                    "upper_error": 0.29,
                    "lower_error": -0.43,
                    "is_upper_limit": false,
                    "is_lower_limit": false
                },
                {
                    "name": "redshift",
                    "unit": "",
                    "description": "na",
                    "best": 0.04,
                    "upper_error": 0.01,
                    "lower_error": -0.02,
                    "is_upper_limit": false,
                    "is_lower_limit": false
                },
                {
                    "name": "total_mass_source",
                    "unit": "M_sun",
                    "description": "na",
                    "best": 3.3,
                    "upper_error": 0.1,
                    "lower_error": -0.1,
                    "is_upper_limit": false,
                    "is_lower_limit": false
                }
            ]
        },
        {
            "name": "GW190425",
            "shortName": "GW190425-v2",
            "gps": 1240215503.0,
            "version": 2,
            "catalog": "GWTC-2",
            "detectors": [
                "H1",
                "L1",
                "V1"
            ],
            "detail_url": "https://gwosc.org/api/v2/event-versions/GW190425-v2?format=api",
            "default_parameters": [
                {
                    "name": "chirp_mass",
                    "unit": "M_sun",
                    "description": "na",
                    "best": 1.49,
                    "upper_error": 0.0008,
                    "lower_error": -0.0006,
                    "is_upper_limit": false,
                    "is_lower_limit": false
                },
                {
                    "name": "chirp_mass_source",
                    "unit": "M_sun",
                    "description": "na",
                    "best": 1.44,
                    "upper_error": 0.02,
                    "lower_error": -0.02,
                    "is_upper_limit": false,
                    "is_lower_limit": false
                },
                {
                    "name": "chi_eff",
                    "unit": "",
                    "description": "na",
                    "best": 0.06,
                    "upper_error": 0.11,
                    "lower_error": -0.05,
                    "is_upper_limit": false,
                    "is_lower_limit": false
                },
                {
                    "name": "luminosity_distance",
                    "unit": "Mpc",
                    "description": "na",
                    "best": 160.0,
                    "upper_error": 70.0,
                    "lower_error": -70.0,
                    "is_upper_limit": false,
                    "is_lower_limit": false
                },
                {
                    "name": "mass_1_source",
                    "unit": "M_sun",
                    "description": "na",
                    "best": 2.0,
                    "upper_error": 0.6,
                    "lower_error": -0.3,
                    "is_upper_limit": false,
                    "is_lower_limit": false
                },
                {
                    "name": "mass_2_source",
                    "unit": "M_sun",
                    "description": "na",
                    "best": 1.4,
                    "upper_error": 0.3,
                    "lower_error": -0.3,
                    "is_upper_limit": false,
                    "is_lower_limit": false
                },
                {
                    "name": "redshift",
                    "unit": "",
                    "description": "na",
                    "best": 0.03,
                    "upper_error": 0.01,
                    "lower_error": -0.02,
                    "is_upper_limit": false,
                    "is_lower_limit": false
                },
                {
                    "name": "total_mass_source",
                    "unit": "M_sun",
                    "description": "na",
                    "best": 3.4,
                    "upper_error": 0.3,
                    "lower_error": -0.1,
                    "is_upper_limit": false,
                    "is_lower_limit": false
                },
                {
                    "name": "far",
                    "unit": "1/yr",
                    "description": "na",
                    "best": 0.000751854698112682,
                    "upper_error": null,
                    "lower_error": null,
                    "is_upper_limit": false,
                    "is_lower_limit": false
                },
                {
                    "name": "network_matched_filter_snr",
                    "unit": "",
                    "description": "na",
                    "best": 13.02922972476558,
                    "upper_error": null,
                    "lower_error": null,
                    "is_upper_limit": false,
                    "is_lower_limit": false
                }
            ]
        },
        {
            "name": "GW190425",
            "shortName": "GW190425_081805-v3",
            "gps": 1240215503.0,
            "version": 3,
            "catalog": "GWTC-2.1-confident",
            "detectors": [
                "H1",
                "L1",
                "V1"
            ],
            "detail_url": "https://gwosc.org/api/v2/event-versions/GW190425-v3?format=api",
            "default_parameters": [
                {
                    "name": "chirp_mass_source",
                    "unit": "M_sun",
                    "description": "na",
                    "best": 1.44,
                    "upper_error": 0.02,
                    "lower_error": -0.02,
                    "is_upper_limit": false,
                    "is_lower_limit": false
                },
                {
                    "name": "chi_eff",
                    "unit": "",
                    "description": "na",
                    "best": 0.07,
                    "upper_error": 0.07,
                    "lower_error": -0.05,
                    "is_upper_limit": false,
                    "is_lower_limit": false
                },
                {
                    "name": "luminosity_distance",
                    "unit": "Mpc",
                    "description": "na",
                    "best": 150.0,
                    "upper_error": 80.0,
                    "lower_error": -60.0,
                    "is_upper_limit": false,
                    "is_lower_limit": false
                },
                {
                    "name": "mass_1_source",
                    "unit": "M_sun",
                    "description": "na",
                    "best": 2.1,
                    "upper_error": 0.5,
                    "lower_error": -0.4,
                    "is_upper_limit": false,
                    "is_lower_limit": false
                },
                {
                    "name": "mass_2_source",
                    "unit": "M_sun",
                    "description": "na",
                    "best": 1.3,
                    "upper_error": 0.3,
                    "lower_error": -0.2,
                    "is_upper_limit": false,
                    "is_lower_limit": false
                },
                {
                    "name": "network_matched_filter_snr",
                    "unit": "",
                    "description": "na",
                    "best": 12.4,
                    "upper_error": 0.4,
                    "lower_error": -0.4,
                    "is_upper_limit": false,
                    "is_lower_limit": false
                },
                {
                    "name": "redshift",
                    "unit": "",
                    "description": "na",
                    "best": 0.03,
                    "upper_error": 0.02,
                    "lower_error": -0.01,
                    "is_upper_limit": false,
                    "is_lower_limit": false
                },
                {
                    "name": "total_mass_source",
                    "unit": "M_sun",
                    "description": "na",
                    "best": 3.4,
                    "upper_error": 0.3,
                    "lower_error": -0.1,
                    "is_upper_limit": false,
                    "is_lower_limit": false
                },
                {
                    "name": "far",
                    "unit": "1/yr",
                    "description": "na",
                    "best": 0.034,
                    "upper_error": null,
                    "lower_error": null,
                    "is_upper_limit": false,
                    "is_lower_limit": false
                },
                {
                    "name": "p_astro",
                    "unit": "",
                    "description": "na",
                    "best": 0.78349,
                    "upper_error": null,
                    "lower_error": null,
                    "is_upper_limit": false,
                    "is_lower_limit": false
                }
            ]
        },
        {
            "name": "GW170817",
            "shortName": "GW170817-v3",
            "gps": 1187008882.4,
            "version": 3,
            "catalog": "GWTC-1-confident",
            "detectors": [
                "G1",
                "H1",
                "L1",
                "V1"
            ],
            "detail_url": "https://gwosc.org/api/v2/event-versions/GW170817-v3?format=api",
            "default_parameters": [
                {
                    "name": "chirp_mass_source",
                    "unit": "M_sun",
                    "description": "na",
                    "best": 1.186,
                    "upper_error": 0.001,
                    "lower_error": -0.001,
                    "is_upper_limit": false,
                    "is_lower_limit": false
                },
                {
                    "name": "chi_eff",
                    "unit": "",
                    "description": "na",
                    "best": 0.0,
                    "upper_error": 0.02,
                    "lower_error": -0.01,
                    "is_upper_limit": false,
                    "is_lower_limit": false
                },
                {
                    "name": "final_mass_source",
                    "unit": "M_sun",
                    "description": "na",
                    "best": 2.8,
                    "upper_error": null,
                    "lower_error": null,
                    "is_upper_limit": true,
                    "is_lower_limit": false
                },
                {
                    "name": "luminosity_distance",
                    "unit": "Mpc",
                    "description": "na",
                    "best": 40.0,
                    "upper_error": 7.0,
                    "lower_error": -15.0,
                    "is_upper_limit": false,
                    "is_lower_limit": false
                },
                {
                    "name": "mass_1_source",
                    "unit": "M_sun",
                    "description": "na",
                    "best": 1.46,
                    "upper_error": 0.12,
                    "lower_error": -0.1,
                    "is_upper_limit": false,
                    "is_lower_limit": false
                },
                {
                    "name": "mass_2_source",
                    "unit": "M_sun",
                    "description": "na",
                    "best": 1.27,
                    "upper_error": 0.09,
                    "lower_error": -0.09,
                    "is_upper_limit": false,
                    "is_lower_limit": false
                },
                {
                    "name": "redshift",
                    "unit": "",
                    "description": "na",
                    "best": 0.01,
                    "upper_error": 0.0,
                    "lower_error": 0.0,
                    "is_upper_limit": false,
                    "is_lower_limit": false
                },
                {
                    "name": "far",
                    "unit": "yr^-1",
                    "description": "na",
                    "best": 1e-07,
                    "upper_error": null,
                    "lower_error": null,
                    "is_upper_limit": true,
                    "is_lower_limit": false
                },
                {
                    "name": "p_astro",
                    "unit": "",
                    "description": "na",
                    "best": 1.0,
                    "upper_error": null,
                    "lower_error": null,
                    "is_upper_limit": false,
                    "is_lower_limit": false
                },
                {
                    "name": "network_matched_filter_snr",
                    "unit": "",
                    "description": "na",
                    "best": 33.0,
                    "upper_error": null,
                    "lower_error": null,
                    "is_upper_limit": false,
                    "is_lower_limit": false
                }
            ]
        }
    ]
}