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

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

{
    "ob_id": 27780,
    "uuid": "34660ad77b744572b70fe6a721cbd4f2",
    "title": "GAUGE: Ecotech Spectronus FTIR greenhouse gas concentrations in Glatton, Cambridgeshire from October 2014 to April 2016",
    "abstract": "This dataset contains concentrations of methane, carbon dioxide, nitrous oxide, and carbon monoxide measured using an Ecotech Spectronus FTIR (Fourier transform infrared spectrometer) in Glatton, Cambridgeshire. The instrument operated from October 2014 to April 2016 in the tower of St Nicholas Church, Glatton. The church is located at 52.461N, 0.304W, and the inlet was located 20m above the ground.\r\n\r\nThis data was collected as part of the Natural Environment Research Council (NERC) Greenhouse gAs Uk and Global Emissions (GAUGE) project.\r\n\r\nThe GAUGE project aimed to determine the magnitude, spatial distribution, and uncertainties of the UK's Greenhouse Gas budget using new and existing measurement networks and modelling approaches at a range of scales.",
    "keywords": "GAUGE, FTIR, methane, carbon dioxide, carbon monoxide, nitrous oxide",
    "publicationState": "published",
    "dataPublishedTime": "2019-09-18T14:49:39",
    "doiPublishedTime": null,
    "updateFrequency": "notPlanned",
    "status": "completed",
    "result_field": {
        "ob_id": "https://api.catalogue.ceda.ac.uk/api/v2/observations/27781/?format=api",
        "dataPath": "/badc/gauge/data/station/glatton/leic-ftir/",
        "oldDataPath": [],
        "storageLocation": "internal",
        "storageStatus": "online",
        "volume": 21089734,
        "numberOfFiles": 2,
        "fileFormat": "Data are BADC CSV formatted."
    },
    "timePeriod": "https://api.catalogue.ceda.ac.uk/api/v2/times/7432/?format=api",
    "geographicExtent": "https://api.catalogue.ceda.ac.uk/api/v2/bboxes/2440/?format=api",
    "nonGeographicFlag": false,
    "phenomena": [
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/59099/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/70274/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/70275/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/70276/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/70277/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/70278/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/70279/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/70280/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/70281/?format=api"
    ],
    "dataLineage": "Data were collected by the University of Leicester and deposited at the Centre for Environmental Data Analysis (CEDA) for archiving.",
    "removedDataTime": null,
    "removedDataReason": "",
    "language": "English",
    "identifier_set": [],
    "projects": [
        "https://api.catalogue.ceda.ac.uk/api/v2/projects/12409/?format=api"
    ],
    "observationcollection_set": [
        "https://api.catalogue.ceda.ac.uk/api/v2/observationcollections/12404/?format=api"
    ],
    "responsiblepartyinfo_set": [
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/116070/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/116071/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/116072/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/116073/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/116074/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/116075/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/116077/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/116076/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/168408/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/116078/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/116079/?format=api"
    ],
    "procedureAcquisition": "https://api.catalogue.ceda.ac.uk/api/v2/acquisitions/27782/?format=api",
    "procedureCompositeProcess": null,
    "procedureComputation": null,
    "permissions": [
        {
            "ob_id": "https://api.catalogue.ceda.ac.uk/api/v2/observations/2528/?format=api",
            "useLimitation": null,
            "accessConstraints": null,
            "accessCategory": "public",
            "accessRoles": null,
            "label": "public: None group",
            "licenceURL": "http://creativecommons.org/licenses/by/4.0/",
            "licenceClassifications": "any"
        }
    ],
    "discoveryKeywords": [
        {
            "ob_id": 1138,
            "name": "NDGO0003"
        }
    ]
}