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

{
    "ob_id": 12855,
    "uuid": "91a09803bd5a42aeb5d3fd530409b15e",
    "title": "ESA Greenhouse Gases Climate Change Initiative (GHG_cci): SCIAMACHY CH4 Level 2 Data Product (CH4_SCI_IMAP), version 7.0, generated with the IMAP-DOAS 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 2 (CRDP#2), the XCH4 SCI 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 SWIR spectra (channel 6) of the SCanning Imaging Absorption spectroMeter for Atmospheric CHartographY (SCIAMACHY) on board the European Space Agency's environmental research satellite ENVISAT. \r\n\r\nThis product has been derived by applying the IMAP-DOAS algorithm developed at the University of Heidelberg and SRON to the SCIAMACHY data. This procedure and the algorithms validity are thoroughly described in Frankenberg et al (2011), a link to which is provided in linked documentation. A second product has also been generated from the SCIAMACHY data using the Weighting Function Modified DOAS (WFM-DOAS) algorithm, and the link to this product's record page is provided in the documentation section. \r\n\r\nThe data product is stored per orbit in a single NetCDF4 file. Retrieval results are provided for the individual SCIAMACHY spatial footprints, no averaging having been applied. The product file contains the key products and information relevant to using the data, such as the vertical layering and averaging kernels. For further details on the product, including the IMAP algorithm and the SCIAMACHY instrument, please see the associated product user guide (PUG) or the Algorithm Theoretical Basis Document in the documentation section.",
    "keywords": "ESA, GHG, GREENHOUSE GASES, CCI, CH4, SCIAMACHY, IMAP",
    "publicationState": "working",
    "dataPublishedTime": null,
    "doiPublishedTime": null,
    "updateFrequency": "",
    "status": "superseded",
    "result_field": {
        "ob_id": "https://api.catalogue.ceda.ac.uk/api/v2/observations/12856/?format=api",
        "dataPath": "/neodc/esacci/ghg/data/crdp_2/L2/SCIAMACHY/CH4_SCI_IMAP/v7.0",
        "oldDataPath": [],
        "storageLocation": "internal",
        "storageStatus": "online",
        "volume": 2078063821,
        "numberOfFiles": 3110,
        "fileFormat": "The data are stored in Netcdf4 format, which can be read with standard tools in the common\r\nprogramming languages (IDL, Matlab, Python etc). Standard readers for HDF5 can also be used as netCDF4 is based on HDF5."
    },
    "timePeriod": "https://api.catalogue.ceda.ac.uk/api/v2/times/3602/?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/11795/?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/11819/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/11820/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/11821/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/11874/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/11875/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/11876/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/11877/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/11878/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/11879/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/11880/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/11881/?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/49130/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/49131/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/49133/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/50854/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/140700/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/140701/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/140703/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/140702/?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": []
}