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

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

{
    "ob_id": 19346,
    "uuid": "ab29c2f3421b426abf1f2786c7cde047",
    "title": "ECMWF trajectories model data for OP3",
    "abstract": "Datasets of 5 day back trajectories have been computed on a routine basis using analyses from the European Centre for Medium Range Weather Forecasting (ECMWF). The three components of the wind and surface pressure over three launch grids covering the UK, the mid-Atlantic storm track region and the eastern USA, plus back trajectories from field campaign instrument sites were used to output datasets consisting of latitude, longitude and pressure of the trajectory every 30 minutes.\r\n\r\nThis dataset contains ECMWF trajectories model data for OP3.",
    "keywords": "ECMWF, model, trajectories",
    "publicationState": "published",
    "dataPublishedTime": "2006-12-10T15:19:22",
    "doiPublishedTime": null,
    "updateFrequency": "asNeeded",
    "status": "completed",
    "result_field": {
        "ob_id": "https://api.catalogue.ceda.ac.uk/api/v2/observations/19347/?format=api",
        "dataPath": "/badc/ecmwf-trj/data/op3/",
        "oldDataPath": [],
        "storageLocation": "internal",
        "storageStatus": "online",
        "volume": 3417250,
        "numberOfFiles": 249,
        "fileFormat": "Data are NASA Ames formatted"
    },
    "timePeriod": "https://api.catalogue.ceda.ac.uk/api/v2/times/5069/?format=api",
    "geographicExtent": "https://api.catalogue.ceda.ac.uk/api/v2/bboxes/1/?format=api",
    "nonGeographicFlag": false,
    "phenomena": [
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/22382/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/57468/?format=api"
    ],
    "dataLineage": "Trajectories generated at the Reading University based on ECMWF data. Initially done in support of the NERC ACSOE programme. Data passed on to the BADC for archiving.",
    "removedDataTime": null,
    "removedDataReason": "",
    "language": "English",
    "identifier_set": [
        "https://api.catalogue.ceda.ac.uk/api/v2/identifiers/12191/?format=api"
    ],
    "projects": [
        "https://api.catalogue.ceda.ac.uk/api/v2/projects/6422/?format=api"
    ],
    "observationcollection_set": [
        "https://api.catalogue.ceda.ac.uk/api/v2/observationcollections/6419/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/observationcollections/47/?format=api"
    ],
    "responsiblepartyinfo_set": [
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/73170/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/73172/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/73169/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/73173/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/73174/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/73175/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/73176/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/73171/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/180551/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/180552/?format=api"
    ],
    "procedureAcquisition": null,
    "procedureCompositeProcess": "https://api.catalogue.ceda.ac.uk/api/v2/composites/6424/?format=api",
    "procedureComputation": null,
    "permissions": [
        {
            "ob_id": "https://api.catalogue.ceda.ac.uk/api/v2/observations/2578/?format=api",
            "useLimitation": null,
            "accessConstraints": null,
            "accessCategory": "restricted",
            "accessRoles": "ecmwftrj",
            "label": "restricted: ecmwftrj group",
            "licenceURL": "https://artefacts.ceda.ac.uk/licences/specific_licences/ukmo_agreement.pdf",
            "licenceClassifications": "academic"
        }
    ],
    "discoveryKeywords": [
        {
            "ob_id": 1138,
            "name": "NDGO0003"
        }
    ]
}