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

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

{
    "ob_id": 30519,
    "uuid": "9abfaf34903e4da7bb2f546855414ea8",
    "title": "ICECAPS-ACE: snow height change taken at Summit Station Greenland",
    "abstract": "This dataset contains the distance to the snow surface from the lowest level of instruments on the 15 m tower at Summit Station, Greenland, detected by a sonic-ranging sensor. Data are collected every 10 minutes and concatenated into monthly files.\r\n\r\nThese data were collected as part of the joint Natural Environmental Research Council (NERC) and US National Science Foundation (NSF) -funded Integrated Characterisation of Energy, Clouds, Atmospheric state, and Precipitation at Summit - Aerosol Cloud Experiment (ICECAPS-ACE) project.\r\n\r\nThese data were continued through the 3 year extension to the ICECAPS-ACE project called ICECAPS-MELT.",
    "keywords": "ICECAPS-ACE, Aerosol, Cloud, Snow, Height",
    "publicationState": "published",
    "dataPublishedTime": "2020-07-03T10:51:34",
    "doiPublishedTime": null,
    "updateFrequency": "asNeeded",
    "status": "ongoing",
    "result_field": {
        "ob_id": "https://api.catalogue.ceda.ac.uk/api/v2/observations/30520/?format=api",
        "dataPath": "/badc/icecaps-ace/data/snow-height",
        "oldDataPath": [],
        "storageLocation": "internal",
        "storageStatus": "online",
        "volume": 169767647,
        "numberOfFiles": 80,
        "fileFormat": "Data are netCDF formatted."
    },
    "timePeriod": "https://api.catalogue.ceda.ac.uk/api/v2/times/8310/?format=api",
    "geographicExtent": "https://api.catalogue.ceda.ac.uk/api/v2/bboxes/2625/?format=api",
    "nonGeographicFlag": false,
    "phenomena": [
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/50512/?format=api",
        "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/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/62250/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/62251/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/62252/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/62253/?format=api"
    ],
    "dataLineage": "Data were collected by the ICECAPS project team 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/30502/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/projects/38309/?format=api"
    ],
    "observationcollection_set": [
        "https://api.catalogue.ceda.ac.uk/api/v2/observationcollections/30507/?format=api"
    ],
    "responsiblepartyinfo_set": [
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/132026/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/132027/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/132028/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/132029/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/132030/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/132031/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/132034/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/132032/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/132834/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/168926/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/132833/?format=api"
    ],
    "procedureAcquisition": "https://api.catalogue.ceda.ac.uk/api/v2/acquisitions/30522/?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"
        }
    ]
}