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

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

{
    "ob_id": 4832,
    "uuid": "62a2c5e2073263a24746e6cf60ce15f5",
    "title": "Convective Storm Initiation Project (CSIP): European Centre for Medium-Range Weather Forecasts (ECMWF) Forecast Charts",
    "abstract": "The European Centre for Medium-Range Weather Forecasts (ECMWF) Forecast Charts are images that display type and amount of cloud, and mean seal level pressure with 12 hour accumulated precipitation measurements. The measurements are taken worldwide. The charts in this dataset are from 1st of June 2005 until the 9th of September 2005.",
    "keywords": "CSIP, ECMWF",
    "publicationState": "published",
    "dataPublishedTime": "2006-08-17T10:19:55",
    "doiPublishedTime": null,
    "updateFrequency": "notPlanned",
    "status": "completed",
    "result_field": {
        "ob_id": "https://api.catalogue.ceda.ac.uk/api/v2/observations/4833/?format=api",
        "dataPath": "/badc/csip/data/ecmwf-charts",
        "oldDataPath": [],
        "storageLocation": "internal",
        "storageStatus": "online",
        "volume": 357443440,
        "numberOfFiles": 3992,
        "fileFormat": "Data are gif formatted."
    },
    "timePeriod": "https://api.catalogue.ceda.ac.uk/api/v2/times/1395/?format=api",
    "geographicExtent": "https://api.catalogue.ceda.ac.uk/api/v2/bboxes/1/?format=api",
    "nonGeographicFlag": false,
    "phenomena": [],
    "dataLineage": "Data were collected by the ECMWF the CSIP project before processing and the delivery to BADC for archiving.",
    "removedDataTime": null,
    "removedDataReason": "",
    "language": "English",
    "identifier_set": [
        "https://api.catalogue.ceda.ac.uk/api/v2/identifiers/3228/?format=api"
    ],
    "projects": [
        "https://api.catalogue.ceda.ac.uk/api/v2/projects/4614/?format=api"
    ],
    "observationcollection_set": [
        "https://api.catalogue.ceda.ac.uk/api/v2/observationcollections/4611/?format=api"
    ],
    "responsiblepartyinfo_set": [
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/21948/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/21947/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/21949/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/21950/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/21951/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/42354/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/42357/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/21953/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/54604/?format=api"
    ],
    "procedureAcquisition": null,
    "procedureCompositeProcess": null,
    "procedureComputation": "https://api.catalogue.ceda.ac.uk/api/v2/computations/3829/?format=api",
    "permissions": [
        {
            "ob_id": "https://api.catalogue.ceda.ac.uk/api/v2/observations/2609/?format=api",
            "useLimitation": null,
            "accessConstraints": null,
            "accessCategory": "restricted",
            "accessRoles": "ecmwfop",
            "label": "restricted: ecmwfop group",
            "licenceURL": "https://artefacts.ceda.ac.uk/licences/specific_licences/ecmwf_op_agreement.pdf",
            "licenceClassifications": "academic"
        }
    ],
    "discoveryKeywords": [
        {
            "ob_id": 1138,
            "name": "NDGO0003"
        }
    ]
}