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

{
    "ob_id": 19977,
    "uuid": "ac5efde71dc14234959488fd780430a9",
    "title": "Environmental Baseline Project: Air quality measurements from Kirby Misperton",
    "abstract": "This dataset contains air quality measurements: atmospheric ozone, NOx and particulate matter,  for the Kirby Misperton site.\r\n\r\nBritish Geological Survey (BGS), the universities of Birmingham, Bristol, Liverpool, Manchester and York and partners from Public Health England (PHE) and the Department for Business, Energy and Industrial Strategy (BEIS), are conducting an independent environmental baseline monitoring programme near Kirby Misperton, North Yorkshire and Little Plumpton, Lancashire. These are areas where planning permission has been granted for hydraulic fracturing.\r\n\r\nThe monitoring allows the characterisation of the environmental baseline before any hydraulic fracturing and gas exploration or production takes place in the event that planning permission is granted. The investigations are independent of any monitoring carried out by the industry or the regulators, and information collected from the programme will be made freely available to the public. \r\n\r\n-----------------------------------------------------------------------------------------------\r\nIf you use these data, please note the requirement to acknowledge use.\r\n\r\nUse of data and information from the project:\r\n\"Science-based environmental baseline monitoring associated with shale gas development in the Vale of Pickering, Yorkshire (including supplementary air quality monitoring in Lancashire)\", led by the British Geological Survey\r\n\r\nPermission for reproduction of data accessed from the CEDA website is granted subject to inclusion of the following acknowledgement:\r\n\"These data were produced by the Universities of Manchester and York (National Centre for Atmospheric Science) in a collaboration with the British Geological Survey and partners from the Universities of Birmingham, Bristol and Liverpool and Public Health England, undertaking a project grant-funded by the Department for Energy & Climate Change (DECC), 2015-2016. \"\r\n----------------------------------------------------------------------------------------------------------",
    "keywords": "ozone, PM10, PM2.5, NOx, air quality",
    "publicationState": "published",
    "dataPublishedTime": "2016-09-28T10:52:28",
    "doiPublishedTime": null,
    "updateFrequency": "",
    "status": "completed",
    "result_field": {
        "ob_id": "https://api.catalogue.ceda.ac.uk/api/v2/observations/19974/?format=api",
        "dataPath": "/badc/env-baseline/data/kirby-misperton/aq",
        "oldDataPath": [],
        "storageLocation": "internal",
        "storageStatus": "online",
        "volume": 193578979,
        "numberOfFiles": 58,
        "fileFormat": "Data are NASA Ames formatted"
    },
    "timePeriod": "https://api.catalogue.ceda.ac.uk/api/v2/times/5231/?format=api",
    "geographicExtent": "https://api.catalogue.ceda.ac.uk/api/v2/bboxes/1637/?format=api",
    "nonGeographicFlag": false,
    "phenomena": [
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/25394/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/61313/?format=api"
    ],
    "dataLineage": "Data collected by the project team and supplied to the Centre of Environmental Data Analysis (CEDA) for archiving.",
    "removedDataTime": null,
    "removedDataReason": "",
    "language": "English",
    "identifier_set": [
        "https://api.catalogue.ceda.ac.uk/api/v2/identifiers/9000/?format=api"
    ],
    "projects": [
        "https://api.catalogue.ceda.ac.uk/api/v2/projects/19625/?format=api"
    ],
    "observationcollection_set": [
        "https://api.catalogue.ceda.ac.uk/api/v2/observationcollections/19978/?format=api"
    ],
    "responsiblepartyinfo_set": [
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/75957/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/75953/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/75954/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/75955/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/75956/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/75958/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/75959/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/75960/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/75950/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/76167/?format=api"
    ],
    "procedureAcquisition": "https://api.catalogue.ceda.ac.uk/api/v2/acquisitions/19976/?format=api",
    "procedureCompositeProcess": null,
    "procedureComputation": null,
    "permissions": [
        {
            "ob_id": "https://api.catalogue.ceda.ac.uk/api/v2/observations/2589/?format=api",
            "useLimitation": null,
            "accessConstraints": null,
            "accessCategory": "registered",
            "accessRoles": null,
            "label": "registered: None group",
            "licenceURL": "https://artefacts.ceda.ac.uk/licences/specific_licences/ebl.pdf",
            "licenceClassifications": "any"
        }
    ],
    "discoveryKeywords": [
        {
            "ob_id": 1138,
            "name": "NDGO0003"
        }
    ]
}