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

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

{
    "ob_id": 29965,
    "uuid": "c7590fe40d8e44169d511c70a60ccbcc",
    "title": "ESA Permafrost Climate Change Initiative (Permafrost_cci):   Permafrost Extent for the Northern Hemisphere, v1.0",
    "abstract": "This dataset contains permafrost extent data produced as part of the European Space Agency's (ESA) Climate Change Initiative (CCI) Permafrost project. It forms part of the Beta version of their Climate Research Data Package (CRDP v0). It is derived from a thermal model driven and constrained by satellite data. Grid products of CDRP v0 are released in annual files, covering the start to the end of the Julian year. This corresponds to average annual ground temperatures which forms the basis for the retrieval of yearly fraction of permafrost-underlain and permafrost-free area within a pixel. A classification according to the IPA (International Permafrost Association) zonation delivers the well-known permafrost zones, distinguishing isolated (0-10%) sporadic (10-50%), discontinuous (50-90%) and continuous permafrost (90-100%). It covers the Northern Hemisphere (north of 30°) for the period 2003-2017.",
    "keywords": "Permafrost, CCI, Permafrost Extent",
    "publicationState": "citable",
    "dataPublishedTime": "2019-12-06T12:58:54",
    "doiPublishedTime": "2019-12-19T14:21:44",
    "updateFrequency": "",
    "status": "superseded",
    "result_field": {
        "ob_id": "https://api.catalogue.ceda.ac.uk/api/v2/observations/29967/?format=api",
        "dataPath": "/neodc/esacci/permafrost/data/permafrost_extent/L4/area4/pp/v01.0/",
        "oldDataPath": [],
        "storageLocation": "internal",
        "storageStatus": "online",
        "volume": 2295770868,
        "numberOfFiles": 16,
        "fileFormat": "NetCDF"
    },
    "timePeriod": "https://api.catalogue.ceda.ac.uk/api/v2/times/8147/?format=api",
    "geographicExtent": "https://api.catalogue.ceda.ac.uk/api/v2/bboxes/2568/?format=api",
    "nonGeographicFlag": false,
    "phenomena": [
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/11952/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/11953/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/27732/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/28270/?format=api"
    ],
    "dataLineage": "Data have been produced by the ESA CCI Permafrost project as part of ESA's Climate Change Initiative programme",
    "removedDataTime": null,
    "removedDataReason": "",
    "language": "English",
    "identifier_set": [
        "https://api.catalogue.ceda.ac.uk/api/v2/identifiers/10669/?format=api"
    ],
    "projects": [
        "https://api.catalogue.ceda.ac.uk/api/v2/projects/29966/?format=api"
    ],
    "observationcollection_set": [
        "https://api.catalogue.ceda.ac.uk/api/v2/observationcollections/29963/?format=api"
    ],
    "responsiblepartyinfo_set": [
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/129445/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/129447/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/129448/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/129453/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/129529/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/141679/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/141680/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/129446/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/129454/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/129488/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/129489/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/129490/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/129491/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/129492/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/129493/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/129568/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/129494/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/129495/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/129496/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/129497/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/129498/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/129499/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/129500/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/129501/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/129502/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/129503/?format=api"
    ],
    "procedureAcquisition": null,
    "procedureCompositeProcess": null,
    "procedureComputation": "https://api.catalogue.ceda.ac.uk/api/v2/computations/29968/?format=api",
    "permissions": [
        {
            "ob_id": "https://api.catalogue.ceda.ac.uk/api/v2/observations/2596/?format=api",
            "useLimitation": null,
            "accessConstraints": null,
            "accessCategory": "public",
            "accessRoles": null,
            "label": "public: None group",
            "licenceURL": "https://artefacts.ceda.ac.uk/licences/specific_licences/esacci_permafrost_terms_and_conditions.pdf",
            "licenceClassifications": ""
        }
    ],
    "discoveryKeywords": [
        {
            "ob_id": 1138,
            "name": "NDGO0003"
        }
    ]
}