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

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

{
    "ob_id": 30042,
    "uuid": "680ebdcb83c244fdb9d069e2f8952812",
    "title": "APHH: Direct infusion ultra-high resolution mass spectrometry measurements made at the IAP-Beijing site during the summer and winter campaigns",
    "abstract": "This dataset contains direct infusion ultra-high resolution mass spectrometry measurements made at the Institute of Atmospheric Physics land station, Beijing (IAP-Beijing) site during the summer and winter APHH-Beijing campaign for the Atmospheric Pollution & Human Health in a Chinese Megacity (APHH) programme.\r\n\r\nDaily quartz microfiber filters were collected with a Tisch high volume sampler. The extracted organic fraction of the collected PM2.5 particles was analysed using an LTQ Orbitrap Velos mass spectrometer with electrospray ionisation to obtain high resolution mass spectra which enable the assignment of molecular formulae to the detected masses.\r\n\r\nFor both seasons, 10 filters were analysed, containing the 5 filters with the highest and lowest mass loadings for each season. The files names are labeled according to the ID of the analysed filter. All dates and times are given in Beijing local time.",
    "keywords": "APHH, spectrometry, PM2.5",
    "publicationState": "published",
    "dataPublishedTime": "2020-03-02T14:25:38",
    "doiPublishedTime": null,
    "updateFrequency": "notPlanned",
    "status": "ongoing",
    "result_field": {
        "ob_id": "https://api.catalogue.ceda.ac.uk/api/v2/observations/30045/?format=api",
        "dataPath": "/badc/aphh/data/beijing/cam-orbitrap",
        "oldDataPath": [],
        "storageLocation": "internal",
        "storageStatus": "online",
        "volume": 4897202,
        "numberOfFiles": 21,
        "fileFormat": "Data are BADC CSV formatted."
    },
    "timePeriod": "https://api.catalogue.ceda.ac.uk/api/v2/times/8162/?format=api",
    "geographicExtent": "https://api.catalogue.ceda.ac.uk/api/v2/bboxes/1856/?format=api",
    "nonGeographicFlag": false,
    "phenomena": [],
    "dataLineage": "Data produced by APHH project participants at University of Cambridge and deposited at The Centre for Environmental Data Analysis (CEDA) for archiving.",
    "removedDataTime": null,
    "removedDataReason": "",
    "language": "English",
    "identifier_set": [],
    "projects": [
        "https://api.catalogue.ceda.ac.uk/api/v2/projects/24808/?format=api"
    ],
    "observationcollection_set": [
        "https://api.catalogue.ceda.ac.uk/api/v2/observationcollections/24817/?format=api"
    ],
    "responsiblepartyinfo_set": [
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/129819/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/129816/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/129817/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/129818/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/129820/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/129821/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/129822/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/129823/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/129815/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/129824/?format=api"
    ],
    "procedureAcquisition": "https://api.catalogue.ceda.ac.uk/api/v2/acquisitions/30044/?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"
        }
    ]
}