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

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

{
    "ob_id": 46194,
    "uuid": "c24e2ac59c094346a45535fe4e51752a",
    "title": "Longterm observations of volatile organic compounds from the NCAS Dual Column Gas Chromatograph- Flame Ionization Detector unit 4 deployed at the Cabo Verde Atmospheric Observatory, v1.0 (20190515-onwards)",
    "abstract": "Observations of volatile organic compound concentrations from the National Centre for Atmospheric Science Atmospheric Measurement and Observation Facility's Dual Column Gas Chromatograph- Flame Ionization Detector unit 4 (ncas-dc-gc-fid-4) deployed at the Cabo Verde Atmospheric Observatory from May 2019.  These observations were taken as part of longterm observations at the site.\r\n\r\nData products from this deployment include: dimethyl sulfide concentrations.\r\n\r\nFor further details of this deployment and the associated dataset please see the internal file metadata.\r\n\r\nThese data conform to the NCAS data standards and are available under the UK Government Open Licence agreement. Acknowledgement of NCAS as the data provider is required whenever and wherever these data are used.",
    "keywords": "NCAS, AMOF, CVAO, Volatile organic compound, Cape Verde, dms, c2h6s, dimethyl sulphide, dimethyl sulfide",
    "publicationState": "preview",
    "dataPublishedTime": null,
    "doiPublishedTime": null,
    "updateFrequency": "notPlanned",
    "status": "completed",
    "result_field": {
        "ob_id": "https://catalogue.ceda.ac.uk/api/v2/observations/46195/?format=api",
        "dataPath": "/badc/ncas-cvao/data/ncas-dc-gc-fid-4/20190515_longterm/v1.0/",
        "oldDataPath": [],
        "storageLocation": "internal",
        "storageStatus": "online",
        "volume": 1889909,
        "numberOfFiles": 2,
        "fileFormat": "NetCDF"
    },
    "timePeriod": "https://catalogue.ceda.ac.uk/api/v2/times/13322/?format=api",
    "geographicExtent": "https://catalogue.ceda.ac.uk/api/v2/bboxes/12/?format=api",
    "nonGeographicFlag": false,
    "phenomena": [
        "https://catalogue.ceda.ac.uk/api/v2/phenomona/53936/?format=api",
        "https://catalogue.ceda.ac.uk/api/v2/phenomona/53937/?format=api",
        "https://catalogue.ceda.ac.uk/api/v2/phenomona/53938/?format=api",
        "https://catalogue.ceda.ac.uk/api/v2/phenomona/53939/?format=api",
        "https://catalogue.ceda.ac.uk/api/v2/phenomona/53940/?format=api",
        "https://catalogue.ceda.ac.uk/api/v2/phenomona/53941/?format=api",
        "https://catalogue.ceda.ac.uk/api/v2/phenomona/53942/?format=api",
        "https://catalogue.ceda.ac.uk/api/v2/phenomona/53943/?format=api",
        "https://catalogue.ceda.ac.uk/api/v2/phenomona/53944/?format=api",
        "https://catalogue.ceda.ac.uk/api/v2/phenomona/58079/?format=api",
        "https://catalogue.ceda.ac.uk/api/v2/phenomona/74110/?format=api",
        "https://catalogue.ceda.ac.uk/api/v2/phenomona/103082/?format=api"
    ],
    "dataLineage": "Data were collected, quality controlled and prepared for archiving by the instrument scientists before upload to the Centre for Environmental Data Analysis (CEDA) for long term archiving.",
    "removedDataTime": null,
    "removedDataReason": "",
    "language": "English",
    "identifier_set": [],
    "projects": [
        "https://catalogue.ceda.ac.uk/api/v2/projects/43720/?format=api"
    ],
    "observationcollection_set": [],
    "responsiblepartyinfo_set": [
        "https://catalogue.ceda.ac.uk/api/v2/rpis/220583/?format=api",
        "https://catalogue.ceda.ac.uk/api/v2/rpis/220584/?format=api",
        "https://catalogue.ceda.ac.uk/api/v2/rpis/220586/?format=api",
        "https://catalogue.ceda.ac.uk/api/v2/rpis/220587/?format=api",
        "https://catalogue.ceda.ac.uk/api/v2/rpis/220588/?format=api",
        "https://catalogue.ceda.ac.uk/api/v2/rpis/220589/?format=api",
        "https://catalogue.ceda.ac.uk/api/v2/rpis/220590/?format=api",
        "https://catalogue.ceda.ac.uk/api/v2/rpis/220592/?format=api",
        "https://catalogue.ceda.ac.uk/api/v2/rpis/220593/?format=api"
    ],
    "procedureAcquisition": "https://catalogue.ceda.ac.uk/api/v2/acquisitions/46196/?format=api",
    "procedureCompositeProcess": null,
    "procedureComputation": null,
    "permissions": [
        {
            "ob_id": "https://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, attribution required"
        }
    ],
    "discoveryKeywords": []
}