Observation Instance – Django REST framework

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/39750/?format=api

HTTP 200 OK
Allow: GET, HEAD, OPTIONS
Content-Type: application/json
Vary: Accept

{
    "ob_id": 39750,
    "uuid": "bb759548ee444168b4554569741c8e61",
    "title": "UKCP18 projected future extreme sea levels at selected tide gauge locations for 2020-2300, using exploratory extended time-mean sea level projections",
    "abstract": "The data are projected extreme sea levels at 46 UK tide gauge locations. The data were produced by the Met Office, using estimates of present-day extreme sea levels provided by the Environment Agency and projections of exploratory extended 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. Confidence levels relating to the 5% and 95% lower and upper bounds of confidence are included.\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 2300 and is available for each decade (i.e., 2020, 2030... 2300).\r\n\r\nFurther information on this dataset and UKCP18 can be found in the documentation section.",
    "keywords": "UKCP18, extreme sea level, UK",
    "publicationState": "published",
    "dataPublishedTime": "2023-03-14T10:11:53",
    "doiPublishedTime": null,
    "updateFrequency": "notPlanned",
    "status": "completed",
    "result_field": {
        "ob_id": "https://api.catalogue.ceda.ac.uk/api/v2/observations/39772/?format=api",
        "dataPath": "/badc/ukcp18/data/marine-sim/ext-sea-lev-expl",
        "oldDataPath": [],
        "storageLocation": "internal",
        "storageStatus": "online",
        "volume": 338311780,
        "numberOfFiles": 4,
        "fileFormat": "Data are in NetCDF format."
    },
    "timePeriod": "https://api.catalogue.ceda.ac.uk/api/v2/times/11003/?format=api",
    "geographicExtent": "https://api.catalogue.ceda.ac.uk/api/v2/bboxes/2303/?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/58992/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/58993/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/62545/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/62546/?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": [],
    "responsiblepartyinfo_set": [
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/193598/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/193597/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/193604/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/193603/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/193602/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/193601/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/193600/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/193599/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/193605/?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": []
}