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

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

{
    "ob_id": 14460,
    "uuid": "24307c6688704c148506bcf041e1dc19",
    "title": "UTLS-OZONE: ECMWF meteorological images",
    "abstract": "UTLS-OZONE was a NERC directed mode programme funding projects to study the upper troposphere and lower stratosphere. The particular emphasis was on the processes determining the distribution of ozone and any subsequent climate impacts. Two UTLS Ozone projects were based on airborne campaigns using the FAAM aircraft, namely ITOP-UK and CIRRUS.\r\n\r\nThis dataset contains ECMWF meteorological images.",
    "keywords": "UTLS, ECMWF, Images",
    "publicationState": "published",
    "dataPublishedTime": "2016-04-14T14:39:08",
    "doiPublishedTime": null,
    "updateFrequency": "notPlanned",
    "status": "completed",
    "result_field": {
        "ob_id": "https://api.catalogue.ceda.ac.uk/api/v2/observations/14463/?format=api",
        "dataPath": "/badc/utls/data/met_images",
        "oldDataPath": [],
        "storageLocation": "internal",
        "storageStatus": "online",
        "volume": 129318074,
        "numberOfFiles": 1048,
        "fileFormat": "Images are PNG formatted"
    },
    "timePeriod": "https://api.catalogue.ceda.ac.uk/api/v2/times/1939/?format=api",
    "geographicExtent": "https://api.catalogue.ceda.ac.uk/api/v2/bboxes/904/?format=api",
    "nonGeographicFlag": false,
    "phenomena": [],
    "dataLineage": "Data files were provided as is in 2002 to the BADC, where they are stored.",
    "removedDataTime": null,
    "removedDataReason": "",
    "language": "English",
    "identifier_set": [],
    "projects": [
        "https://api.catalogue.ceda.ac.uk/api/v2/projects/14426/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/projects/14435/?format=api"
    ],
    "observationcollection_set": [],
    "responsiblepartyinfo_set": [
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/56105/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/56106/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/56108/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/56109/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/56110/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/56111/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/56104/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/56107/?format=api"
    ],
    "procedureAcquisition": null,
    "procedureCompositeProcess": null,
    "procedureComputation": "https://api.catalogue.ceda.ac.uk/api/v2/computations/6423/?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"
        }
    ]
}