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

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

{
    "ob_id": 12399,
    "uuid": "a3931d0dfcc243ab8d93603c8ee58811",
    "title": "Gridded Global Surface Ozone Metrics data (1971-2015) for Atmospheric Chemistry Model Evaluation - version 2.4",
    "abstract": "This dataset consists of version 2.4 gridded surface ozone metrics for atmospheric chemistry model evaluation. These data have global coverage on both monthly and annual timescales from 1971-2015. Multiple model resolutions were used and can be easily identified within the filename. \r\n\r\nData are stored as NetCDF-4 files, with one file per model resolution at each time resolution. The files hold gridded surface ozone data from multiple databases (WMO GAW, EPA CASTNET, EPA AQS, Canadian CAPMON, Canadian NAPS, European EMEP, European AirBase, East Asian Acid Deposition Monitoring Network EANET), plus metadata. Metrics include the moments of the distribution, percentiles, maximum daily eight-hour average (MDA8), SOMO35, AOT40, and metrics related to air quality regulatory thresholds. In addition, metadata for all contributing sites (e.g. Site name, latitude, longitude) are included in each file.",
    "keywords": "Ozone",
    "publicationState": "citable",
    "dataPublishedTime": "2015-06-30T15:14:56",
    "doiPublishedTime": "2015-06-30T23:00:00",
    "updateFrequency": "notPlanned",
    "status": "completed",
    "result_field": {
        "ob_id": "https://api.catalogue.ceda.ac.uk/api/v2/observations/12403/?format=api",
        "dataPath": "/badc/proc-earth-model/data/ozone-metrics/v2.4",
        "oldDataPath": [],
        "storageLocation": "internal",
        "storageStatus": "online",
        "volume": 15131965112,
        "numberOfFiles": 17,
        "fileFormat": "Data is formatted in NetCDF-4"
    },
    "timePeriod": "https://api.catalogue.ceda.ac.uk/api/v2/times/3336/?format=api",
    "geographicExtent": "https://api.catalogue.ceda.ac.uk/api/v2/bboxes/529/?format=api",
    "nonGeographicFlag": false,
    "phenomena": [
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/1050/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/1635/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/1636/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/11360/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/11361/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/11362/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/11363/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/11364/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/11365/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/11366/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/11367/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/11368/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/11369/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/11370/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/11371/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/11372/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/11373/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/11374/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/11375/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/11376/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/11377/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/11378/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/11379/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/11380/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/11381/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/11382/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/11383/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/11384/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/25394/?format=api"
    ],
    "dataLineage": "Data were processed by the authors and delivered to CEDA for archiving",
    "removedDataTime": null,
    "removedDataReason": "",
    "language": "English",
    "identifier_set": [
        "https://api.catalogue.ceda.ac.uk/api/v2/identifiers/8392/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/identifiers/8393/?format=api"
    ],
    "projects": [
        "https://api.catalogue.ceda.ac.uk/api/v2/projects/12368/?format=api"
    ],
    "observationcollection_set": [
        "https://api.catalogue.ceda.ac.uk/api/v2/observationcollections/12398/?format=api"
    ],
    "responsiblepartyinfo_set": [
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/47335/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/47337/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/47338/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/47341/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/47336/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/47340/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/129584/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/47339/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/47334/?format=api"
    ],
    "procedureAcquisition": null,
    "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"
        }
    ]
}