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

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

{
    "ob_id": 1873,
    "uuid": "5545adc3ffe692348d25ae54a051aacf",
    "title": "Met Office MSLP Charts images 1999-2014 from the Met Office's GCPS Commercial System",
    "abstract": "UK Met Office charts analyses pertaining to Mean Surface Level Pressure and 24 hour Weather Frontal Forecasting for the UK and Western Europe. The charts in this dataset have been produced by the Met Office's GPCS Commercial Suite and covers the period 7th June 1999 to 24th June 2014. At this point the Met Office turned off that service and switched to providing images produced by the Met Office's SWIFT system using VisualWeather (available as part of a separate dataset).",
    "keywords": "mlsp, charts, atmospheric pressure, met office, fronts, depressions, lows, highs",
    "publicationState": "published",
    "dataPublishedTime": "2014-09-22T02:28:24",
    "doiPublishedTime": null,
    "updateFrequency": "notPlanned",
    "status": "completed",
    "result_field": {
        "ob_id": "https://api.catalogue.ceda.ac.uk/api/v2/observations/1874/?format=api",
        "dataPath": "/badc/ukmo-charts/data/gpcs-mslp-charts_1999-2014/",
        "oldDataPath": [],
        "storageLocation": "internal",
        "storageStatus": "online",
        "volume": 168170506,
        "numberOfFiles": 4476,
        "fileFormat": "Files are GIF formatted images"
    },
    "timePeriod": "https://api.catalogue.ceda.ac.uk/api/v2/times/501/?format=api",
    "geographicExtent": "https://api.catalogue.ceda.ac.uk/api/v2/bboxes/30/?format=api",
    "nonGeographicFlag": false,
    "phenomena": [
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/25886/?format=api"
    ],
    "dataLineage": "Data, over the period June 1999 to the present, are produced by the Met Office's operational model system then disseminated to the BADC through the Met Office's operational dissemination system. Data are ingested daily.",
    "removedDataTime": null,
    "removedDataReason": "",
    "language": "English",
    "identifier_set": [
        "https://api.catalogue.ceda.ac.uk/api/v2/identifiers/1350/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/identifiers/8394/?format=api"
    ],
    "projects": [
        "https://api.catalogue.ceda.ac.uk/api/v2/projects/555/?format=api"
    ],
    "observationcollection_set": [
        "https://api.catalogue.ceda.ac.uk/api/v2/observationcollections/1872/?format=api"
    ],
    "responsiblepartyinfo_set": [
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/5432/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/5433/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/5438/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/5435/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/5436/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/5437/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/5439/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/5434/?format=api"
    ],
    "procedureAcquisition": null,
    "procedureCompositeProcess": null,
    "procedureComputation": null,
    "permissions": [
        {
            "ob_id": "https://api.catalogue.ceda.ac.uk/api/v2/observations/2532/?format=api",
            "useLimitation": null,
            "accessConstraints": null,
            "accessCategory": "restricted",
            "accessRoles": "ukmo_wx",
            "label": "restricted: ukmo_wx group",
            "licenceURL": "https://artefacts.ceda.ac.uk/licences/specific_licences/ukmo_agreement.pdf",
            "licenceClassifications": "academic"
        },
        {
            "ob_id": "https://api.catalogue.ceda.ac.uk/api/v2/observations/2533/?format=api",
            "useLimitation": null,
            "accessConstraints": null,
            "accessCategory": "restricted",
            "accessRoles": "ukmo_wx_gov",
            "label": "restricted: ukmo_wx_gov group",
            "licenceURL": "https://artefacts.ceda.ac.uk/licences/specific_licences/ukmo_agreement_gov.pdf",
            "licenceClassifications": "policy"
        }
    ],
    "discoveryKeywords": [
        {
            "ob_id": 1138,
            "name": "NDGO0003"
        }
    ]
}