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

{
    "ob_id": 24004,
    "uuid": "aa448fd749954539afa60e04379f6e5c",
    "title": "UKCP09: Climate change projections of storm surge trend for UK waters",
    "abstract": "The UKCP09 marine & coastal storm surge data provides projections of surge height for the linear trend, the 5th and 95th percentiles throughout the 21st Century for 2, 10, 20 and 50 year return period events (including statistical significance) over a 12km coastal grid. Data are available for a medium emissions scenario (IPCC SRES: A1B), to reflect some aspects of the uncertainty in modelling global and regional climate change eleven different variants of the Met Office Hadley Centre climate model HadCM3 were used to drive eleven corresponding variants of the HadRM3 regional model, which in turn drove the National Oceanography Centre storm surge model (POLCS3).\r\n\r\nNote: The projections do not cover all plausible future outcomes and unlike some other components of UKCP09, the storm surge height projections are not probabilistic, although a range is provided based on the assumption that the 11 simulations are equally likely.\r\n\r\nMore information about the storm surge methodology (including assumptions and caveats) are given in Chapter 4 of the UKCP09 Marine & coastal projections report and the technical note on storm projections.",
    "keywords": "UKCP09, UK storm surge, climate projections",
    "publicationState": "published",
    "dataPublishedTime": "2017-09-05T13:01:51",
    "doiPublishedTime": null,
    "updateFrequency": "notPlanned",
    "status": "completed",
    "result_field": {
        "ob_id": "https://api.catalogue.ceda.ac.uk/api/v2/observations/24012/?format=api",
        "dataPath": "/badc/ukcp09/data/projections/storm_surge",
        "oldDataPath": [],
        "storageLocation": "internal",
        "storageStatus": "online",
        "volume": 1380788,
        "numberOfFiles": 2,
        "fileFormat": "The data are NetCDF formatted and adhere to v1.0 of the CF data conventions."
    },
    "timePeriod": "https://api.catalogue.ceda.ac.uk/api/v2/times/6542/?format=api",
    "geographicExtent": "https://api.catalogue.ceda.ac.uk/api/v2/bboxes/674/?format=api",
    "nonGeographicFlag": false,
    "phenomena": [
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/52664/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/52665/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/56453/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/56454/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/56455/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/92048/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/92049/?format=api"
    ],
    "dataLineage": "Original data were produced by the Met Office as part of the UKCP09 service before preparation for archival with the Centre for Environmental Data Analysis (CEDA).",
    "removedDataTime": null,
    "removedDataReason": "",
    "language": "English",
    "identifier_set": [],
    "projects": [
        "https://api.catalogue.ceda.ac.uk/api/v2/projects/12930/?format=api"
    ],
    "observationcollection_set": [
        "https://api.catalogue.ceda.ac.uk/api/v2/observationcollections/23999/?format=api"
    ],
    "responsiblepartyinfo_set": [
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/98539/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/98541/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/98542/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/98543/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/98544/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/98545/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/98547/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/98548/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/98540/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/98546/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/168556/?format=api"
    ],
    "procedureAcquisition": null,
    "procedureCompositeProcess": null,
    "procedureComputation": "https://api.catalogue.ceda.ac.uk/api/v2/computations/24686/?format=api",
    "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"
        }
    ]
}