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

{
    "ob_id": 39573,
    "uuid": "8b4c2455c27a4f0581e753be50ed94c7",
    "title": "UKCP projected future extreme sea levels at approximately 2 km spacing around the UK coastline for 2020-2100, using 21st century time-mean sea level projections",
    "abstract": "The data are projected extreme sea levels at approximately 2 km spacing around the UK coastline, including England, Wales, Scotland, Northern Ireland, and Isle of Man. The data were produced by the Met Office, using estimates of present-day extreme sea levels at all open-coast Coastal Flood Boundary point locations, provided by the Environment Agency and projections of 21st Century time-mean sea level change prepared at the Met Office.  \r\n\r\nProjected extreme sea level values are described for 16 different annual probabilities of exceedance (return levels), ranging from 1:1 to 1:10,000, identified in the shapefile as ‘t1’ to ‘t10000’. Confidence levels relating to the 5% and 95% lower and upper bounds of confidence are included, identified in the shapefile with the prefix ‘c1_’ and ‘c3_’ respectively, as well as the 70% confidence level identified in the shapefile with the prefix ‘c2_’. \r\n\r\nThe data were produced to put the projected future mean sea level change in the context of the present-day extremes. The data were produced by combining the best estimates of present-day extreme sea levels with projections of mean sea level change. The data covers the period from 2020 to 2100 and is available for each decade (i.e., 2020, 2030... 2100).\r\n\r\nFurther information on this dataset and UKCP18 can be found in the documentation section.",
    "keywords": "UKCP, extreme sea level, UK",
    "publicationState": "published",
    "dataPublishedTime": "2023-03-14T10:12:47",
    "doiPublishedTime": null,
    "updateFrequency": "notPlanned",
    "status": "completed",
    "result_field": {
        "ob_id": "https://api.catalogue.ceda.ac.uk/api/v2/observations/39774/?format=api",
        "dataPath": "/badc/ukcp18/data/marine-sim/ext-sea-lev-shp",
        "oldDataPath": [],
        "storageLocation": "internal",
        "storageStatus": "online",
        "volume": 16441733,
        "numberOfFiles": 28,
        "fileFormat": "The data are provided as zipped shapefiles."
    },
    "timePeriod": "https://api.catalogue.ceda.ac.uk/api/v2/times/10970/?format=api",
    "geographicExtent": "https://api.catalogue.ceda.ac.uk/api/v2/bboxes/2303/?format=api",
    "nonGeographicFlag": false,
    "phenomena": [],
    "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": [],
    "responsiblepartyinfo_set": [
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/192988/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/192979/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/192986/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/192985/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/192983/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/192982/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/192981/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/192980/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/192987/?format=api"
    ],
    "procedureAcquisition": null,
    "procedureCompositeProcess": null,
    "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"
        }
    ]
}