GET

Observation Instance

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/14554/?format=api
HTTP 200 OK
Allow: GET, HEAD, OPTIONS
Content-Type: application/json
Vary: Accept

{
    "ob_id": 14554,
    "uuid": "cca6035bb0f240ffbb035e9355f09fe1",
    "title": "ESA Greenhouse Gases Climate Change Initiative (GHG CCI): GOSAT CH4 Proxy Level 2 Data Product (CH4_GOS_SRPR), version 2.3.7, generated with the SRPR (RemoTeC) algorithm",
    "abstract": "Part of the European Space Agency's (ESA) Greenhouse Gases (GHG) Climate Change Initiative (CCI) project and the Climate Research Data Package Number 3 (CRDP#3), the XCH4 GOS SRPR (Proxy) product comprises a level 2, column-averaged dry-air mole fraction (mixing ratio) for methane (CH4). The product has been produced using data acquired from the Thermal and Near Infrared Sensor for Carbon Observations (TANSO-FTS) NIR and SWIR spectra, onboard the Japanese Greenhouse gases Observing Satellite (GOSAT). \r\n\r\nThis proxy version of the product has been generated using the RemoTeC SRPR algorithm, which is being jointly developed at SRON and KIT. This has been designated as an 'alternative' GHG CCI algorithm, and a separate product has also been generated by applying the baseline GHG CCI proxy algorithm (the University of Leicester OCPR algorithm). It is advised that users who aren't sure whether to use the baseline or alternative product use the OCPR product generated with the baseline algorithm. For more information regarding the differences between the baseline and alternative algorithms please see the GHG-CCI data products webpage. \r\n\r\nThe data product is stored per day in a single NetCDF file. Retrieval results are provided for the individual GOSAT spatial footprints, no averaging having been applied. As well as containing the key product, the product file contains information relevant for the use of the data, such as the vertical layering and averaging kernels. The parameters which are retrieved simultaneously with XCH4 are also included (e.g. surface albedo), in addition to retrieval diagnostics like quality of the fit and retrieval errors. For further details on the product, including the RemoTeC algorithm and the TANSO-FTS instrument, please see the associated product user guide (PUG) or the Algorithm Theoretical Basis Documents in the documentation section.\r\n\r\nThe GHG-CCI team encourage all users of their products to register with them to receive information on any updates or issues regarding the data products and to receive notification of new product releases.\r\nTo register, please use the following link: http://www.iup.uni-bremen.de/sciamachy/NIR_NADIR_WFM_DOAS/CRDP_REG/",
    "keywords": "ESA, GHG, CCI, CH4, Proxy, RemoTeC, Greenhouse Gas",
    "publicationState": "published",
    "dataPublishedTime": "2016-04-11T08:26:43",
    "doiPublishedTime": null,
    "updateFrequency": "",
    "status": "superseded",
    "result_field": {
        "ob_id": "https://api.catalogue.ceda.ac.uk/api/v2/observations/14555/?format=api",
        "dataPath": "/neodc/esacci/ghg/data/crdp_3/GOSAT/CH4_GOS_SRPR/2.3.7/",
        "oldDataPath": [],
        "storageLocation": "internal",
        "storageStatus": "online",
        "volume": 2231344861,
        "numberOfFiles": 2028,
        "fileFormat": "Data are in NetCDF format"
    },
    "timePeriod": "https://api.catalogue.ceda.ac.uk/api/v2/times/3843/?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/1050/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/1635/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/1636/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/11790/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/11791/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/11792/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/11793/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/11794/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/11795/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/11797/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/11798/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/11799/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/11803/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/11804/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/11807/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/11808/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/11809/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/11810/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/11811/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/11812/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/11814/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/11815/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/11816/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/11817/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/11818/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/11820/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/11822/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/11823/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/11825/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/11826/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/11827/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/11832/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/11846/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/13266/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/13267/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/13268/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/13270/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/13272/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/13273/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/13422/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/13423/?format=api"
    ],
    "dataLineage": "Data were processed by the ESA CCI GHG project team and supplied to CEDA as part of the ESA CCI Open Data Portal Project",
    "removedDataTime": null,
    "removedDataReason": "",
    "language": "English",
    "identifier_set": [],
    "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/56442/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/56441/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/56440/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/56439/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/104892/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/105107/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/105286/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/56563/?format=api"
    ],
    "procedureAcquisition": null,
    "procedureCompositeProcess": null,
    "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": 1138,
            "name": "NDGO0003"
        }
    ]
}