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

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

{
    "ob_id": 41437,
    "uuid": "77a0e1e3bcbb49a5b4c89fe9cc90a788",
    "title": "DCMEX: aerosol number-size distribution data from Langmuir ground station for the New Mexico field campaign 2022 - Version 1.0",
    "abstract": "Aerosol number-size distribution data collected by the University of Manchester at the Kiva-2 site at Langmuir ground station in the Magdalena Mountains, New Mexico, between July and August 2022 as part of the Deep Convective Microphysics Experiment (DCMEX) project. Instrument supplied by the National Centre for Atmospheric Science - Atmospheric Measurement and Observation Facility (NCAS-AMOF).\r\n\r\nThis version 1.0 dataset contains the aerosol size distribution data from the Kiva-2 site at Langmuir Laboratory. A GRIMM Optical Particle Counter (OPC) model 1.108 was installed at the Langmuir Laboratory Kiva-2 site (33.97495N, 107.18100W, ~3255 m). The GRIMM OPC was supported by AMOF and the University of Manchester scientists.",
    "keywords": "aerosol, ncas-amof, ncas-opc-1",
    "publicationState": "citable",
    "dataPublishedTime": "2024-02-06T09:42:45",
    "doiPublishedTime": null,
    "updateFrequency": "notPlanned",
    "status": "completed",
    "result_field": {
        "ob_id": "https://api.catalogue.ceda.ac.uk/api/v2/observations/42896/?format=api",
        "dataPath": "/badc/ncas-mobile/data/ncas-opc-1/20220715_dcmex/v1.0",
        "oldDataPath": [],
        "storageLocation": "internal",
        "storageStatus": "online",
        "volume": 144628104,
        "numberOfFiles": 27,
        "fileFormat": "Data are netCDF formatted."
    },
    "timePeriod": "https://api.catalogue.ceda.ac.uk/api/v2/times/11551/?format=api",
    "geographicExtent": "https://api.catalogue.ceda.ac.uk/api/v2/bboxes/4139/?format=api",
    "nonGeographicFlag": false,
    "phenomena": [
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/53936/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/53937/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/53938/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/53939/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/53940/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/53941/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/53942/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/53943/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/53944/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/74110/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/75052/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/75061/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/75236/?format=api"
    ],
    "dataLineage": "Data were collected by the University of Manchester and National Centre for Atmospheric Science (NCAS) Atmospheric Measurement and Observation Facility (AMOF) instrument scientists before preparation for archiving and delivery to the Centre for Environmental Data Analysis (CEDA).",
    "removedDataTime": null,
    "removedDataReason": "",
    "language": "English",
    "identifier_set": [],
    "projects": [
        "https://api.catalogue.ceda.ac.uk/api/v2/projects/38131/?format=api"
    ],
    "observationcollection_set": [
        "https://api.catalogue.ceda.ac.uk/api/v2/observationcollections/38137/?format=api"
    ],
    "responsiblepartyinfo_set": [
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/201995/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/201996/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/201997/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/201998/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/201999/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/202000/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/202007/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/202003/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/202002/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/202006/?format=api"
    ],
    "procedureAcquisition": "https://api.catalogue.ceda.ac.uk/api/v2/acquisitions/41439/?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"
        }
    ]
}