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

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

{
    "ob_id": 27474,
    "uuid": "311d8ce894f742bb84fa7dd639ea1b2c",
    "title": "GAUGE: Carbon Dioxide measurements taken from Tacolneston Tower",
    "abstract": "This dataset contains measurements of enrichment of 14C in carbon dioxide in air  taken from Tacolneston  tower. The samples were taken at 185m and analysed by Aerosol Mass Spectrometer (AMS) at Keck-Carbon Cycle AMS facility, University of California, Irvine.\r\n\r\nThis data was collected as part of the NERC GAUGE (Greenhouse gAs UK and Global Emissions) project (NE/K002449/1NERC and TRN1028/06/2015). The GAUGE project aimed to produce robust estimates of the UK Greenhouse Gas budget, using new and existing measurement networks and modelling activities at a range of scales. It aimed to integrate inter-calibrated information from ground-based, airborne, ferry-borne, balloon-borne, and space-borne sensors, including new sensor technology.",
    "keywords": "GAUGE, CO2, Tower, Carbon Dioxide",
    "publicationState": "published",
    "dataPublishedTime": "2019-05-08T15:46:08",
    "doiPublishedTime": null,
    "updateFrequency": "notPlanned",
    "status": "completed",
    "result_field": {
        "ob_id": "https://api.catalogue.ceda.ac.uk/api/v2/observations/27481/?format=api",
        "dataPath": "/badc/gauge/data/tower/tacolneston/",
        "oldDataPath": [],
        "storageLocation": "internal",
        "storageStatus": "online",
        "volume": 14825,
        "numberOfFiles": 2,
        "fileFormat": "NetCDF"
    },
    "timePeriod": "https://api.catalogue.ceda.ac.uk/api/v2/times/7373/?format=api",
    "geographicExtent": "https://api.catalogue.ceda.ac.uk/api/v2/bboxes/2399/?format=api",
    "nonGeographicFlag": false,
    "phenomena": [
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/50416/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/50542/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/50543/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/68286/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/68287/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/90734/?format=api"
    ],
    "dataLineage": "Data were collected by the University of Bristol 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/114854/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/114851/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/114852/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/114853/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/114855/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/114856/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/114900/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/114857/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/114850/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/114859/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/114860/?format=api"
    ],
    "procedureAcquisition": "https://api.catalogue.ceda.ac.uk/api/v2/acquisitions/27482/?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"
        }
    ]
}