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

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

{
    "ob_id": 39892,
    "uuid": "5bdabb4cba5d43e6a577f72ae03ca25b",
    "title": "OSCA IOP-1 Summer:  Roadside site gas data (June-July 2021)",
    "abstract": "Measurements of a range of atmospheric gases made during the Integrated Research Observation System for Clean Air (OSCA) Intensive Operations Project 1 (IOP) in Summer (June-July) 2021 at the Manchester Air Quality Site (MAQS) and the Upper Brook Street, Manchester, roadside site.\r\n\r\nThis dataset include measurements of Soil NOx using the Lancaster University Dynamic Soil Chambers  connected to a Teledyne N500 NOx analyser, hydrogen chloride using the Tunable IR Laser Direct Absorption Spectrometer (TILDAS) at the MAQS site,  and carbon dioxide (CO2), Nitrous oxides (NOx) and Volatile Organic Compounds (VOCs) at the roadside site in Manchester",
    "keywords": "OSCA, maqs, air quality, OSCA-AQ",
    "publicationState": "published",
    "dataPublishedTime": "2023-04-06T16:18:25",
    "doiPublishedTime": null,
    "updateFrequency": "asNeeded",
    "status": "ongoing",
    "result_field": {
        "ob_id": "https://api.catalogue.ceda.ac.uk/api/v2/observations/39902/?format=api",
        "dataPath": "/badc/osca/data/iop-1-summer/",
        "oldDataPath": [],
        "storageLocation": "internal",
        "storageStatus": "online",
        "volume": 333093080,
        "numberOfFiles": 6,
        "fileFormat": "BADC-CSV"
    },
    "timePeriod": "https://api.catalogue.ceda.ac.uk/api/v2/times/11032/?format=api",
    "geographicExtent": "https://api.catalogue.ceda.ac.uk/api/v2/bboxes/3794/?format=api",
    "nonGeographicFlag": false,
    "phenomena": [
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/76067/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/76070/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/76071/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/76074/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/76076/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/76077/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/76078/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/76082/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/76083/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/76086/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/76088/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/76089/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/76091/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/76092/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/76095/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/76097/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/76098/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/76099/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/76103/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/76105/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/83868/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/83869/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/83870/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/83871/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/83872/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/83873/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/83874/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/83875/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/83876/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/83877/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/83878/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/83879/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/83880/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/83881/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/83882/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/83883/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/83884/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/83885/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/83886/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/83887/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/83888/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/83889/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/83890/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/83891/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/83892/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/83893/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/83894/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/83895/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/83896/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/83897/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/83898/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/83899/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/83900/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/83901/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/83902/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/83903/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/83904/?format=api"
    ],
    "dataLineage": "Data was collected  by the instrument operators and uploaded to CEDA.\r\nRoadside data was collected using the WACL Air Sampling Platform by Samuel Cliff at the University of York and converted into BADC format in R.",
    "removedDataTime": null,
    "removedDataReason": "",
    "language": "English",
    "identifier_set": [],
    "projects": [
        "https://api.catalogue.ceda.ac.uk/api/v2/projects/37963/?format=api"
    ],
    "observationcollection_set": [
        "https://api.catalogue.ceda.ac.uk/api/v2/observationcollections/37907/?format=api"
    ],
    "responsiblepartyinfo_set": [
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/194199/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/194192/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/194195/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/194196/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/194197/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/194198/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/194193/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/194194/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/194203/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/194204/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/194205/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/194206/?format=api"
    ],
    "procedureAcquisition": "https://api.catalogue.ceda.ac.uk/api/v2/acquisitions/39897/?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": []
}