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

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

{
    "ob_id": 37941,
    "uuid": "03fd47b671b9482293ba122d3b7044da",
    "title": "Black Carbon and Ultraviolet Particulate Matter Levels detected from a Magee Scientific Aethalometer Model AE33 Instrument at Manchester Air Quality Site, 2019 onwards",
    "abstract": "Use of Magee Scientific Aethalometer Model AE33 Instrument to measure the Black Carbon and Ultraviolet Particulate Matter Levels from the Particlate Matter in Air Data at Manchester Air Quality Site (MAQS) from 2019 onwards. Black Carbon measurements were obtained using electromagnetic wavelengths 370, 470, 520, 590, 660, 880, 950 nm.",
    "keywords": "OSCA, maqs, air quality, OSCA-AQ, BC",
    "publicationState": "published",
    "dataPublishedTime": "2023-01-17T12:06:05",
    "doiPublishedTime": null,
    "updateFrequency": "monthly",
    "status": "ongoing",
    "result_field": {
        "ob_id": "https://api.catalogue.ceda.ac.uk/api/v2/observations/39751/?format=api",
        "dataPath": "/badc/osca/data/manchester/OSCA_MAQS_AE33_BC_UVPM",
        "oldDataPath": [],
        "storageLocation": "internal",
        "storageStatus": "online",
        "volume": 536639586,
        "numberOfFiles": 175,
        "fileFormat": "NetCDF and BADC-CSV"
    },
    "timePeriod": "https://api.catalogue.ceda.ac.uk/api/v2/times/10477/?format=api",
    "geographicExtent": "https://api.catalogue.ceda.ac.uk/api/v2/bboxes/3601/?format=api",
    "nonGeographicFlag": false,
    "phenomena": [
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/58082/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/58083/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/65554/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/65555/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/65556/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/65557/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/65558/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/65564/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/65565/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/65566/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/65712/?format=api"
    ],
    "dataLineage": "Data is transfered directly from the instrument to the computer database, before being transferred to the general database, where it is processed, averaged over minute time intervals and flagged where data is suspect. Data processing software found in: https://github.com/ncasuk/AMF_CVs/releases/tag/v1.0.0\r\nAetholometer Data is obtained between July 2019 and April 2022.",
    "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/181107/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/181108/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/181109/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/181110/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/181111/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/181112/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/181117/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/181118/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/181119/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/181334/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/181120/?format=api"
    ],
    "procedureAcquisition": "https://api.catalogue.ceda.ac.uk/api/v2/acquisitions/37944/?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": []
}