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

{
    "ob_id": 25886,
    "uuid": "8eb35b1ab1b2476986d174a2f0231307",
    "title": "IASI global monthly averages of effective sulphur dioxide (SO2) column amounts, 2007 - 2014, version 1.0",
    "abstract": "This dataset contains global monthly averaged effective sulphur dioxide (SO2) column amounts derived from the Infrared Atmospheric Sounding Interferometer (IASI) instrument  on the METOP-A satellite.  The data have been produced by the University of Oxford as part of the NERC Centre for the Observation and Modelling of Earthquakes, Volcanoes and Tectonics (COMET). \r\n\r\nThis dataset has been produced using the Walker et al. (2011, 2012) linear retrieval developed for the Infrared Atmospheric Sounding Interferometer, which is able to detect sulphur dioxide (SO2) gas. This dataset  contains monthly averages of this retrieval output from June 2007 to December 2014 across the globe, within which it is possible to identify the period and the location of when we have an anomaly of SO2 in atmosphere. This includes volcanic eruptions alongside non-eruptive volcanic degassing, and human pollution sources. \r\n\r\nWithin the dataset are the average effective SO2 column amounts in Dobson Units (DU) for 0.125º by 0.125º gridboxes across the globe. Also included for each grid box are the standard deviation, and the number of pixel boxes contributing to the mean. The results from this dataset are discussed in Taylor et al. (2018) 'Exploring the utility of IASI for monitoring volcanic SO2 emissions' in review at JGR: Atmospheres.",
    "keywords": "IASI, SO2, volcanic emissions, satellite observation, thermal infrared spectra",
    "publicationState": "published",
    "dataPublishedTime": "2018-03-15T11:50:00",
    "doiPublishedTime": null,
    "updateFrequency": "notPlanned",
    "status": "completed",
    "result_field": {
        "ob_id": "https://api.catalogue.ceda.ac.uk/api/v2/observations/25890/?format=api",
        "dataPath": "/neodc/iasi_so2_oxford/data/monthly_mean/v1.0",
        "oldDataPath": [],
        "storageLocation": "internal",
        "storageStatus": "online",
        "volume": 4535221367,
        "numberOfFiles": 92,
        "fileFormat": "Data are in NetCDF format"
    },
    "timePeriod": "https://api.catalogue.ceda.ac.uk/api/v2/times/6990/?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/1635/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/1636/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/23299/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/23300/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/23301/?format=api"
    ],
    "dataLineage": "These data were produced by the Earth Observation Data Group, Atmospheric, Oceanic and Planetary Physics, University of Oxford, as part of the NERC Centre for the Observation and Modelling of Earthquakes, Volcanoes and Tectonics (COMET). These data were then supplied to CEDA to be archived.",
    "removedDataTime": null,
    "removedDataReason": "",
    "language": "English",
    "identifier_set": [
        "https://api.catalogue.ceda.ac.uk/api/v2/identifiers/9521/?format=api"
    ],
    "projects": [
        "https://api.catalogue.ceda.ac.uk/api/v2/projects/11687/?format=api"
    ],
    "observationcollection_set": [
        "https://api.catalogue.ceda.ac.uk/api/v2/observationcollections/25891/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/observationcollections/30127/?format=api"
    ],
    "responsiblepartyinfo_set": [
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/108298/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/108296/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/108297/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/108230/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/108232/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/108233/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/108234/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/108235/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/108236/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/108295/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/108237/?format=api"
    ],
    "procedureAcquisition": null,
    "procedureCompositeProcess": "https://api.catalogue.ceda.ac.uk/api/v2/composites/25889/?format=api",
    "procedureComputation": null,
    "permissions": [
        {
            "ob_id": "https://api.catalogue.ceda.ac.uk/api/v2/observations/2522/?format=api",
            "useLimitation": null,
            "accessConstraints": null,
            "accessCategory": "registered",
            "accessRoles": null,
            "label": "registered: None group",
            "licenceURL": "http://www.nationalarchives.gov.uk/doc/open-government-licence/version/3/",
            "licenceClassifications": "any"
        }
    ],
    "discoveryKeywords": [
        {
            "ob_id": 1138,
            "name": "NDGO0003"
        }
    ]
}