Get a list of Observation objects.

### Available end points:

- `/observations/` - Will list all Results in the database
- `/observations.json` - Will return all Results in json format. This can
also be achieved by using the accept header. `application/json`
- `/observations/<object_id>/` - Returns Results object with that id

### Available Methods:

- `GET`
- `HEAD`

### Available filters:

- `title`
- `uuid`
- `keywords`
- `status`
- `result_field`
- `discoveryKeywords`
- `updateFrequency`
- `nonGeographicFlag`
- `publicationState`
- `permissions`

### How to use filters:

These filters can be used like django query filters using __ for related model relationships.

- `/observations/?uuid=d594d53df2612bbd89c2e0e770b5c1a0`
- `/observations/?status=completed`
- `/observations/?results_field__dataPath__startswith=/neodc/esacci`
- `/observations/?discoveryKeywords__name=ESACCI`
- `/observations/?nonGeographicFlag=True`

Filters can be stacked to build an 'AND' relationship. E.g.

- `/observations/?publicationState__in=published,citable&nonGeographicFlag=True`
- `/observations/?publicationState__in=published,citable&discoveryKeyword__name=NDGO0003`

GET /api/v2/observations/41262/?format=api
HTTP 200 OK
Allow: GET, HEAD, OPTIONS
Content-Type: application/json
Vary: Accept

{
    "ob_id": 41262,
    "uuid": "2c1cb1d606c4421e9339a3028839a41f",
    "title": "ESA Greenhouse Gases Climate Change Initiative (GHG_cci): Column averaged carbon dioxide from OCO-2 generated with the FOCAL algorithm, version 10.1",
    "abstract": "This dataset contains column-average dry-air mole fractions of atmospheric carbon dioxide (XCO2), using the fast atmospheric trace gas retrieval for OCO2 (FOCAL-OCO2). The FOCAL-OCO2 algorithm which has been setup to retrieve XCO2 by analysing hyper spectral solar backscattered radiance measurements from NASA's Orbiting Carbon Observatory 2 (OCO-2) satellite. FOCAL includes a radiative transfer model which has been developed to approximate light scattering effects by multiple scattering at an optically thin scattering layer. This reduces the computational costs by several orders of magnitude. FOCAL's radiative transfer model is utilised to simulate the radiance in all three OCO-2 spectral bands allowing the simultaneous retrieval of CO2, H2O, and solar induced chlorophyll fluorescence. The product is limited to cloud-free scenes on the Earth's day side. This dataset is also referred to as CO2_OC2_FOCA.\r\n\r\nThis version of the data (v10.1) was produced as part of the European Space Agency's (ESA) \r\nClimate Change Initiative (CCI) Greenhouse Gases (GHG) project (GHG-CCI+, http://cci.esa.int/ghg)\r\nand got co-funding from the University of Bremen and EU H2020 projects CHE (grant agreement no. 776186) and VERIFY (grant agreement no. 776810).\r\n\r\nWhen citing this data, please also cite the following peer-reviewed publications:\r\n\r\nM.Reuter, M.Buchwitz, O.Schneising, S.Noël, V.Rozanov, H.Bovensmann and J.P.Burrows: A Fast Atmospheric Trace Gas Retrieval for Hyperspectral Instruments Approximating Multiple Scattering - Part 1: Radiative Transfer and a Potential OCO-2 XCO2 Retrieval Setup, Remote Sensing, 9(11), 1159; doi:10.3390/rs9111159, 2017\r\n\r\nM.Reuter, M.Buchwitz, O.Schneising, S.Noël, H.Bovensmann and J.P.Burrows: A Fast Atmospheric Trace Gas Retrieval for Hyperspectral Instruments Approximating Multiple Scattering - Part 2: Application to XCO2 Retrievals from OCO-2, Remote Sensing, 9(11), 1102; doi:10.3390/rs9111102, 2017",
    "keywords": "ESA, CCI, satellite, carbon dioxide, CO2",
    "publicationState": "citable",
    "dataPublishedTime": "2024-02-20T16:47:59",
    "doiPublishedTime": "2024-03-01T10:06:50.290059",
    "updateFrequency": "notPlanned",
    "status": "completed",
    "result_field": {
        "ob_id": "https://api.catalogue.ceda.ac.uk/api/v2/observations/41431/?format=api",
        "dataPath": "/neodc/esacci/ghg/data/cci_plus/CO2_OC2_FOCA/v10.1",
        "oldDataPath": [],
        "storageLocation": "internal",
        "storageStatus": "online",
        "volume": 57708787190,
        "numberOfFiles": 2550,
        "fileFormat": "Data are in netCDF format."
    },
    "timePeriod": "https://api.catalogue.ceda.ac.uk/api/v2/times/11499/?format=api",
    "geographicExtent": "https://api.catalogue.ceda.ac.uk/api/v2/bboxes/529/?format=api",
    "nonGeographicFlag": false,
    "phenomena": [
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/50542/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/50543/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/55529/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/55532/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/55533/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/55534/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/55535/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/63576/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/69629/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/74866/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/74867/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/74868/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/74869/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/74870/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/74871/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/74872/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/74873/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/74874/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/74876/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/74877/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/75344/?format=api"
    ],
    "dataLineage": "The FOCAL OCO-2 XCO2 retrieval development, data processing and analysis has received co-funding from ESA’s Climate Change Initiative (CCI+) via project GHG-CCI+ (contract 4000126450/19/I-NB, https://climate.esa.int/en/projects/ghgs) EUMETSAT via the FOCAL-CO2M study (contract EUM/CO/19/4600002372/RL), the European Union via the Horizon 2020 (H2020) projects VERIFY (Grant Agreement No. 776810, http://verify.lsce.ipsl.fr) and CHE (Grant Agreement No. 776186, https://www.che-project.eu) and by the State and the University of Bremen.\r\n\r\nData were supplied to CEDA for archiving as part of the ESA CCI Open Data Portal.",
    "removedDataTime": null,
    "removedDataReason": "",
    "language": "English",
    "identifier_set": [
        "https://api.catalogue.ceda.ac.uk/api/v2/identifiers/12836/?format=api"
    ],
    "projects": [
        "https://api.catalogue.ceda.ac.uk/api/v2/projects/13295/?format=api"
    ],
    "observationcollection_set": [
        "https://api.catalogue.ceda.ac.uk/api/v2/observationcollections/12808/?format=api"
    ],
    "responsiblepartyinfo_set": [
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/200821/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/200822/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/200823/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/200824/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/200825/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/200826/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/200827/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/200828/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/200829/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/200830/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/200831/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/200832/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/200833/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/200834/?format=api"
    ],
    "procedureAcquisition": null,
    "procedureCompositeProcess": "https://api.catalogue.ceda.ac.uk/api/v2/composites/33058/?format=api",
    "procedureComputation": null,
    "permissions": [
        {
            "ob_id": "https://api.catalogue.ceda.ac.uk/api/v2/observations/2564/?format=api",
            "useLimitation": null,
            "accessConstraints": null,
            "accessCategory": "public",
            "accessRoles": null,
            "label": "public: None group",
            "licenceURL": "https://artefacts.ceda.ac.uk/licences/specific_licences/esacci_ghg_terms_and_conditions.pdf",
            "licenceClassifications": "any"
        }
    ],
    "discoveryKeywords": [
        {
            "ob_id": 1140,
            "name": "ESACCI"
        }
    ]
}