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

{
    "ob_id": 26020,
    "uuid": "e5297a0c0329426380d4cd6e58c48f45",
    "title": "UKCP18 Simulated Impact of Mean Sea Level Change on Tidal Characteristics around the UK",
    "abstract": "The data are simulated instantaneous sea surface elevations above time-mean sea level due to tides alone. The data were produced by the Met Office Hadley Centre. The data were produced to investigate the impact of simulated mean sea level increase on UK coastal tides. To produce the data, the CS3 continental shelf model was used to simulate the tides under various different amounts of mean sea level  increase (simulated by simply increasing the bathymetry). The data are the resulting simulated sea surface elevations above the mean sea level. The data covers a period of about 28 days (one spring-neap cycle), and applies to the UK coast.\r\n\r\nThere are several caveats which should be noted when using the ‘UKCP18 Simulated Impact of Mean Sea Level Change on Tidal Characteristics around the UK’ dataset:\r\n1.\tThe spin-up period has been included in the data. It takes about 48 hours to spin up to a realistic tide so users should remove the first 48 hours of data, or conduct their own analysis to assess how much spin-up time to remove, in order to get a realistic representation of the tide.\r\n2.\tA land-sea mask has not been applied to the data so users should take care to ensure they are only using data from sea locations.\r\n3.\tThere is a rim of zeros around the edge of the data which should be ignored.\r\n\r\nFurther information on this dataset and UKCP18 can be found in the documentation section.",
    "keywords": "UKCP18, Marine, Tide Surge, Historical, Projections, Case Studies",
    "publicationState": "published",
    "dataPublishedTime": "2018-11-26T09:00:00",
    "doiPublishedTime": null,
    "updateFrequency": "asNeeded",
    "status": "ongoing",
    "result_field": {
        "ob_id": "https://api.catalogue.ceda.ac.uk/api/v2/observations/26150/?format=api",
        "dataPath": "/badc/ukcp18/data/marine-sim/tide-proj",
        "oldDataPath": [],
        "storageLocation": "internal",
        "storageStatus": "online",
        "volume": 5389618282,
        "numberOfFiles": 22,
        "fileFormat": "Data are NetCDF formatted"
    },
    "timePeriod": "https://api.catalogue.ceda.ac.uk/api/v2/times/7024/?format=api",
    "geographicExtent": "https://api.catalogue.ceda.ac.uk/api/v2/bboxes/2211/?format=api",
    "nonGeographicFlag": false,
    "phenomena": [
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/51186/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/51187/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/56586/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/56763/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/62353/?format=api"
    ],
    "dataLineage": "Data provided by the UK Met Office",
    "removedDataTime": null,
    "removedDataReason": "",
    "language": "English",
    "identifier_set": [],
    "projects": [
        "https://api.catalogue.ceda.ac.uk/api/v2/projects/26015/?format=api"
    ],
    "observationcollection_set": [
        "https://api.catalogue.ceda.ac.uk/api/v2/observationcollections/26160/?format=api"
    ],
    "responsiblepartyinfo_set": [
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/143648/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/111116/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/111117/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/111118/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/111120/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/110957/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/111122/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/111119/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/111121/?format=api"
    ],
    "procedureAcquisition": null,
    "procedureCompositeProcess": null,
    "procedureComputation": "https://api.catalogue.ceda.ac.uk/api/v2/computations/26151/?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"
        }
    ]
}