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

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

{
    "ob_id": 2122,
    "uuid": "ad1cbeaf262404e79e124bce232790bb",
    "title": "ARDAAOS: Middle atmospheric assimilated data from the Reading assimilated atmospheric satellite",
    "abstract": "The Reading Assimilated Atmospheric Satellite Data presents an analyses of stratospheric and tropospheric temperature, ozone and water vapour incorporating data from research satellites and operational observations, assimilated with the Hadley Centre Atmospheric Model (HADAM3) configuration of the Unified Model (UM). \r\n\r\nThis dataset includes 3-D global fields for selected periods of time in the 1990s and is produced as part of the Assimilation of Remote-sensed Data for Applications in the Atmospheric and Oceanographic Sciences (ARDAAOS) Natural Environment Research Council (NERC) thematic programme.",
    "keywords": "ARDAAOS, NERC, remote sensor",
    "publicationState": "published",
    "dataPublishedTime": "2007-02-27T00:01:38",
    "doiPublishedTime": null,
    "updateFrequency": "notPlanned",
    "status": "completed",
    "result_field": {
        "ob_id": "https://api.catalogue.ceda.ac.uk/api/v2/observations/2123/?format=api",
        "dataPath": "/badc/nerc-assim-prog/data/tropostra",
        "oldDataPath": [],
        "storageLocation": "internal",
        "storageStatus": "online",
        "volume": 51341564,
        "numberOfFiles": 86,
        "fileFormat": "Data are netCDF formatted"
    },
    "timePeriod": "https://api.catalogue.ceda.ac.uk/api/v2/times/566/?format=api",
    "geographicExtent": "https://api.catalogue.ceda.ac.uk/api/v2/bboxes/1/?format=api",
    "nonGeographicFlag": false,
    "phenomena": [
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/21771/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/25394/?format=api"
    ],
    "dataLineage": "Data prepared by project participants prior to archival at the BADC",
    "removedDataTime": null,
    "removedDataReason": "",
    "language": "English",
    "identifier_set": [
        "https://api.catalogue.ceda.ac.uk/api/v2/identifiers/1499/?format=api"
    ],
    "projects": [
        "https://api.catalogue.ceda.ac.uk/api/v2/projects/2124/?format=api"
    ],
    "observationcollection_set": [
        "https://api.catalogue.ceda.ac.uk/api/v2/observationcollections/2121/?format=api"
    ],
    "responsiblepartyinfo_set": [
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/9240/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/9244/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/9247/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/9239/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/9238/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/9241/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/9242/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/9243/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/9245/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/9246/?format=api"
    ],
    "procedureAcquisition": null,
    "procedureCompositeProcess": null,
    "procedureComputation": "https://api.catalogue.ceda.ac.uk/api/v2/computations/2125/?format=api",
    "permissions": [
        {
            "ob_id": "https://api.catalogue.ceda.ac.uk/api/v2/observations/2526/?format=api",
            "useLimitation": null,
            "accessConstraints": null,
            "accessCategory": "public",
            "accessRoles": null,
            "label": "public: None group",
            "licenceURL": "http://www.nationalarchives.gov.uk/doc/open-government-licence/version/3/",
            "licenceClassifications": "any"
        }
    ],
    "discoveryKeywords": [
        {
            "ob_id": 1138,
            "name": "NDGO0003"
        }
    ]
}