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

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

{
    "ob_id": 13772,
    "uuid": "e8a3561149c0448fa34bd64f072d69f1",
    "title": "Relative humidity data from 23 stations on Kilimanjaro (East Africa) over three years",
    "abstract": "Data were collected under the NERC funded project - The role of land-use change on influencing mountain climate on Kilimanjaro, East Africa (NE/J013366/1) - lead by Dr Nicholas Pepin (University of Portsmouth) which investigated the influence of land-use on surface climate (temperature and moisture availability) on Mount Kilimanjaro in Africa. \r\n\r\nRelative humidity measurements were taken at hourly intervals at 23 stations on Mount Kilimanjaro between September 2012 and September 2015. Specific station locations (elevation and lat/long) are stated in the data and are ordered in a transect across the mountain from South-West over the top to North-East. \r\n\r\nTwo of the stations have both ground level and air level sensors (hence there are 25 readings not 23).  \r\n\r\nAdditional information about station locations and missing data can be found in a PDF on the CEDA archive.    ",
    "keywords": "temperature, relative humidity, Kilimanjaro, mountain",
    "publicationState": "published",
    "dataPublishedTime": "2016-02-08T12:16:36",
    "doiPublishedTime": null,
    "updateFrequency": "notPlanned",
    "status": "completed",
    "result_field": {
        "ob_id": "https://api.catalogue.ceda.ac.uk/api/v2/observations/13788/?format=api",
        "dataPath": "/badc/kilimanjaro-climate/data/v1/relative-humidity",
        "oldDataPath": [],
        "storageLocation": "internal",
        "storageStatus": "online",
        "volume": 4176277,
        "numberOfFiles": 2,
        "fileFormat": "BADC-CSV"
    },
    "timePeriod": "https://api.catalogue.ceda.ac.uk/api/v2/times/3685/?format=api",
    "geographicExtent": "https://api.catalogue.ceda.ac.uk/api/v2/bboxes/771/?format=api",
    "nonGeographicFlag": false,
    "phenomena": [
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/12669/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/12670/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/12696/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/12697/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/12698/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/12699/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/12700/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/12701/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/12702/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/12703/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/12704/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/12705/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/12706/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/12707/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/12708/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/12709/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/12710/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/12711/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/12712/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/12713/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/12714/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/12715/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/12716/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/12717/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/12718/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/12719/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/12720/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/12721/?format=api"
    ],
    "dataLineage": "Provided by project PI for archival at CEDA",
    "removedDataTime": null,
    "removedDataReason": "",
    "language": "English",
    "identifier_set": [],
    "projects": [
        "https://api.catalogue.ceda.ac.uk/api/v2/projects/12135/?format=api"
    ],
    "observationcollection_set": [
        "https://api.catalogue.ceda.ac.uk/api/v2/observationcollections/13771/?format=api"
    ],
    "responsiblepartyinfo_set": [
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/52748/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/52743/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/52742/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/52745/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/52746/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/52747/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/52750/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/52749/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/52744/?format=api"
    ],
    "procedureAcquisition": "https://api.catalogue.ceda.ac.uk/api/v2/acquisitions/13791/?format=api",
    "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"
        }
    ]
}