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

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

{
    "ob_id": 472,
    "uuid": "7813e2af753c2f556a9333e29e99c691",
    "title": "JAIVEX: Met Office operational unified model (UM) output",
    "abstract": "This dataset contains output from the Met Office operational unified model (UM) in support of the Joint Airborne IASI Validation Experiment (JAIVEX). \r\n\r\nThe Infrared Atmospheric Sounding Interferometer (IASI) instrument was launched on the METOP satellite in October 2006 (delayed from April 2006). The European Organisation for the Exploitation of Meteorological Satellites (Eumetsat) provided funds for the Facility for Airborne Atmospheric Measurement (FAAM) aircraft BAe146 to be involved in validation of IASI radiative transfer and some level 2 products. Flights were flown over oceans to coincide with METOP satellite overpasses. Further low level flights were flown over specific land calibration sites to characterise land surface emissivity. This dataset does not contain data collected by IASI on the Metop satellite.",
    "keywords": "JAIVEX, model, nwp, IASI, MetOp",
    "publicationState": "published",
    "dataPublishedTime": "2008-08-15T13:55:34",
    "doiPublishedTime": null,
    "updateFrequency": "notPlanned",
    "status": "completed",
    "result_field": {
        "ob_id": "https://api.catalogue.ceda.ac.uk/api/v2/observations/473/?format=api",
        "dataPath": "/badc/jaivex/data/metoffice_model_fields",
        "oldDataPath": [],
        "storageLocation": "internal",
        "storageStatus": "online",
        "volume": 465278144,
        "numberOfFiles": 47,
        "fileFormat": "Data are netCDF formatted"
    },
    "timePeriod": "https://api.catalogue.ceda.ac.uk/api/v2/times/127/?format=api",
    "geographicExtent": "https://api.catalogue.ceda.ac.uk/api/v2/bboxes/5/?format=api",
    "nonGeographicFlag": false,
    "phenomena": [
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/1319/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/1320/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/1321/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/1322/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/1323/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/1324/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/55779/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/56834/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/56835/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/74532/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/91475/?format=api"
    ],
    "dataLineage": "Data obtained produced by the Met Office and supplied to the Joint Airborne IASI (Infrared Atmospheric Sounding Interferometer) Validation Experiment (JAIVEX) project team.  Data also obtained by the Infrared Atmospheric Sounding Interferometer (IASI) instrument on the METOP satellite in April and September 2007. Data provided as is by FAAM JAIVEX campaign participants as the campaign unfolded for archiving at the BADC.",
    "removedDataTime": null,
    "removedDataReason": "",
    "language": "English",
    "identifier_set": [
        "https://api.catalogue.ceda.ac.uk/api/v2/identifiers/8947/?format=api"
    ],
    "projects": [
        "https://api.catalogue.ceda.ac.uk/api/v2/projects/474/?format=api"
    ],
    "observationcollection_set": [
        "https://api.catalogue.ceda.ac.uk/api/v2/observationcollections/471/?format=api"
    ],
    "responsiblepartyinfo_set": [
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/1323/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/1321/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/1327/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/1325/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/1326/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/1329/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/1324/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/1322/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/71542/?format=api"
    ],
    "procedureAcquisition": null,
    "procedureCompositeProcess": null,
    "procedureComputation": "https://api.catalogue.ceda.ac.uk/api/v2/computations/475/?format=api",
    "permissions": [
        {
            "ob_id": "https://api.catalogue.ceda.ac.uk/api/v2/observations/2526/?format=api",
            "useLimitation": null,
            "accessConstraints": null,
            "accessCategory": "public",
            "accessRoles": null,
            "label": "public: None group",
            "licenceURL": "http://www.nationalarchives.gov.uk/doc/open-government-licence/version/3/",
            "licenceClassifications": "any"
        }
    ],
    "discoveryKeywords": [
        {
            "ob_id": 1138,
            "name": "NDGO0003"
        }
    ]
}