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

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

{
    "ob_id": 33327,
    "uuid": "ba8180a9876a4ef1a127046a673d8864",
    "title": "ClearfLo: IOP Winter atmospheric chemistry and meteorology measurements and NAME Airmass Footprint dispersion model output across London sites",
    "abstract": "ClearfLo (Clean Air for London) Project was a collaborative scientific project involving several academic institutions in the UK, which aimed to set up air pollution monitoring sites alongside meteorological measurements to investigate boundary layer pollution across London.\r\n\r\nThis dataset contains NAME airmass footprint images and  a broad suite of chemistry and meteorological measurements at Detling, North Kensington, and King's College, London during the winter Intensive Operations Period (IOP) in January and February 2012.",
    "keywords": "ClearfLo, pollution, chemistry, meteorology",
    "publicationState": "published",
    "dataPublishedTime": "2021-11-24T15:06:06",
    "doiPublishedTime": null,
    "updateFrequency": "notPlanned",
    "status": "completed",
    "result_field": {
        "ob_id": "https://api.catalogue.ceda.ac.uk/api/v2/observations/33328/?format=api",
        "dataPath": "/badc/clearflo/data/iop/winter",
        "oldDataPath": [],
        "storageLocation": "internal",
        "storageStatus": "online",
        "volume": 702836713,
        "numberOfFiles": 3139,
        "fileFormat": "NASA-Ames and NetCDF"
    },
    "timePeriod": "https://api.catalogue.ceda.ac.uk/api/v2/times/9154/?format=api",
    "geographicExtent": "https://api.catalogue.ceda.ac.uk/api/v2/bboxes/2886/?format=api",
    "nonGeographicFlag": false,
    "phenomena": [
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/4385/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/13294/?format=api",
        "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/60511/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/60512/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/60513/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/60514/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/60515/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/60516/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/60517/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/60518/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/60519/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/60520/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/60521/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/60522/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/60523/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/60524/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/60525/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/60526/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/60527/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/60528/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/60529/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/60530/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/60531/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/60532/?format=api"
    ],
    "dataLineage": "Data are collected and processed by the instrument operators and uploaded to the ClearfLo (Clean Air for London) data archive at CEDA.",
    "removedDataTime": null,
    "removedDataReason": "",
    "language": "English",
    "identifier_set": [],
    "projects": [
        "https://api.catalogue.ceda.ac.uk/api/v2/projects/3933/?format=api"
    ],
    "observationcollection_set": [
        "https://api.catalogue.ceda.ac.uk/api/v2/observationcollections/3930/?format=api"
    ],
    "responsiblepartyinfo_set": [
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/148851/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/148852/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/148853/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/148854/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/148855/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/148856/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/148857/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/148858/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/148882/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/148883/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/148884/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/148885/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/148886/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/148887/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/148888/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/148889/?format=api"
    ],
    "procedureAcquisition": null,
    "procedureCompositeProcess": "https://api.catalogue.ceda.ac.uk/api/v2/composites/14545/?format=api",
    "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"
        }
    ]
}