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

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

{
    "ob_id": 5005,
    "uuid": "00cc4b46f53408de0b397beaf209ec0b",
    "title": "Global maps of monthly self-calibrating Palmer Drought Severity Index (scPDSI) based on the Climatic Research Unit Time Series (CRU TS) 3.10.01 data (1901-2009)",
    "abstract": "scPDSI consists of global maps of monthly self-calibrating Palmer Drought Severity Index (scPDSI) which have been calculated for 1901-2009 based on the CRU TS 3.10.01 data sets.\r\n\r\nThe Palmer Drought Severity Index (PDSI) is a measure of soil moisture availability that has been\r\nused extensively to study droughts and wet spells in the contiguous USA and elsewhere, particularly as the primary indicator of the severity and extent of recent droughts. Recently, the PDSI has become more popular as a drought metric in studies quantifying possible trends in future soil moisture availability and it has been used as the basis for reconstructing past variations in drought.\r\n",
    "keywords": "",
    "publicationState": "published",
    "dataPublishedTime": "2013-12-17T22:12:40",
    "doiPublishedTime": null,
    "updateFrequency": "notPlanned",
    "status": "completed",
    "result_field": {
        "ob_id": "https://api.catalogue.ceda.ac.uk/api/v2/observations/5006/?format=api",
        "dataPath": "/badc/cru/data/PDSI/PDSI_CRU_TS_3.10.01_based",
        "oldDataPath": [],
        "storageLocation": "internal",
        "storageStatus": "online",
        "volume": 1356252223,
        "numberOfFiles": 13,
        "fileFormat": "Data are netCDF formatted."
    },
    "timePeriod": "https://api.catalogue.ceda.ac.uk/api/v2/times/1442/?format=api",
    "geographicExtent": "https://api.catalogue.ceda.ac.uk/api/v2/bboxes/513/?format=api",
    "nonGeographicFlag": false,
    "phenomena": [
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/50559/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/50561/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/55508/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/62353/?format=api"
    ],
    "dataLineage": "3.10.01 data files supplied by KNMI in November 2013.",
    "removedDataTime": null,
    "removedDataReason": "",
    "language": "English",
    "identifier_set": [
        "https://api.catalogue.ceda.ac.uk/api/v2/identifiers/3318/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/identifiers/8337/?format=api"
    ],
    "projects": [
        "https://api.catalogue.ceda.ac.uk/api/v2/projects/12154/?format=api"
    ],
    "observationcollection_set": [
        "https://api.catalogue.ceda.ac.uk/api/v2/observationcollections/5004/?format=api"
    ],
    "responsiblepartyinfo_set": [
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/22502/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/22504/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/22505/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/41012/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/46238/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/22503/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/22501/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/41015/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/41013/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/46239/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/72493/?format=api"
    ],
    "procedureAcquisition": null,
    "procedureCompositeProcess": null,
    "procedureComputation": "https://api.catalogue.ceda.ac.uk/api/v2/computations/12153/?format=api",
    "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"
        }
    ]
}