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

{
    "ob_id": 20369,
    "uuid": "86d964d18ac242a58e13bb8d1c849b48",
    "title": "NERC Mesosphere-Stratosphere-Troposphere (MST) Radar: stratospheric and tropospheric structure and dynamics observations, version 4.0",
    "abstract": "The Natural Environment Research Council (NERC) Mesosphere-Stratosphere-Troposphere (MST) Radar is operated by the Science and Technology Facilities Council (STFC) at the Radar Facility's (MSTRF's) site in Capel Dewi, near Aberystwyth, Mid-Wales. \r\n\r\nThis dataset contains time-series of vertical profiles of derived atmospheric dynamics (wind speed, direction) and structure (indications of refractive index structures and turbulence) from observations taken from the 46.5 MHz pulsed Doppler radar. It is primarily used for making atmospheric observations over the approximate altitude range 2 - 20 km, i.e. of the free troposphere (above the boundary layer) and the lower stratosphere, known as the \"ST-mode\". Additional observations are made over the approximate altitude range 56 - 96 km, i.e. covering the mesosphere - known as the \"M-mode\" (see related dataset); hence the term \"MST\" radar.\r\n\r\nThe instrument has been in operation, using the Doppler Beam Swinging technique (see linked documentation for further details), since late 1989. It was initially operated on a campaign basis, but switched to quasi-continuous observations (i.e. close to 24-7 operation) in late 1997. In 2011 the radar system underwent renovation with significant improvements in radar performance. \r\n\r\nThe version 4.0 (v4.0) data processing scheme is closely related to the version 3 (v3) scheme and uses v3 Cartesian files as input. The main difference is that the horizontal wind components in the v4 Cardinal files represent time averages, which have a smaller random measurement error compared to the single cycle estimates in the v3 Cartesian files.\r\n\r\nData products available from the v4 Cardinal files include time-series profiles of:\r\n - eastward wind\r\n - northward wind\r\n - upward wind\r\n - (radar return) signal power (giving an indication of atmospheric structure) - also known as echo power\r\n - (beam broadening) corrected spectral width (giving a measure of turbulence intensity)\r\n - tropopause altitude and sharpness\r\n\r\nA full list of variables will be added to this record in due course.\r\n\r\nQuick look plots for these data are available  - see related links under the \"docs\" tab below.\r\n\r\nNote - some files are released marked as '-suspect'. These have been released to permit early access to the data where the majority of data are known to pass quality control, but a small, limited part of the data have been identified as being 'suspect'. An internal remark about the suspect data may be found within the file's metadata 'comments' attribute.",
    "keywords": "MST Radar, NERC, troposphere, stratosphere, wind speed, wind direction, profiles, echo power, turbulence",
    "publicationState": "published",
    "dataPublishedTime": "2017-08-17T08:34:49",
    "doiPublishedTime": null,
    "updateFrequency": "daily",
    "status": "ongoing",
    "result_field": {
        "ob_id": "https://api.catalogue.ceda.ac.uk/api/v2/observations/20370/?format=api",
        "dataPath": "/badc/mst/data/nerc-mstrf-radar-mst/v4-0/st-mode/cardinal/",
        "oldDataPath": [],
        "storageLocation": "internal",
        "storageStatus": "online",
        "volume": 7922318500,
        "numberOfFiles": 5675,
        "fileFormat": "Data are NetCDF formatted."
    },
    "timePeriod": "https://api.catalogue.ceda.ac.uk/api/v2/times/6745/?format=api",
    "geographicExtent": "https://api.catalogue.ceda.ac.uk/api/v2/bboxes/515/?format=api",
    "nonGeographicFlag": false,
    "phenomena": [
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/13200/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/21769/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/22316/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/22318/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/22320/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/22321/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/25407/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/25852/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/25857/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/25864/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/25963/?format=api"
    ],
    "dataLineage": "Data are acquired by the MST radar facility and sent to Centre for Environmental Data Analysis (CEDA) within an hour of acquisition. Data are then immediately ingested into the CEDA Archives.",
    "removedDataTime": null,
    "removedDataReason": "",
    "language": "English",
    "identifier_set": [],
    "projects": [
        "https://api.catalogue.ceda.ac.uk/api/v2/projects/25330/?format=api"
    ],
    "observationcollection_set": [
        "https://api.catalogue.ceda.ac.uk/api/v2/observationcollections/6117/?format=api"
    ],
    "responsiblepartyinfo_set": [
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/79173/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/79176/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/79175/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/79177/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/79171/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/79170/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/79174/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/79172/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/79178/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/79179/?format=api"
    ],
    "procedureAcquisition": "https://api.catalogue.ceda.ac.uk/api/v2/acquisitions/6162/?format=api",
    "procedureCompositeProcess": null,
    "procedureComputation": null,
    "permissions": [
        {
            "ob_id": "https://api.catalogue.ceda.ac.uk/api/v2/observations/2543/?format=api",
            "useLimitation": null,
            "accessConstraints": null,
            "accessCategory": "registered",
            "accessRoles": null,
            "label": "registered: None group",
            "licenceURL": "https://artefacts.ceda.ac.uk/licences/missing_licence.pdf",
            "licenceClassifications": "unstated"
        }
    ],
    "discoveryKeywords": [
        {
            "ob_id": 1138,
            "name": "NDGO0003"
        }
    ]
}