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

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

{
    "ob_id": 5728,
    "uuid": "0b937e45fd18e72e5b98e2f2a64ac905",
    "title": "Clee Hill C-band rain radar single polar products",
    "abstract": "Single-polar products from the Met Office's Clee Hill C-band rain radar, Shropshire, England. Data include reflectivity and augmented Doppler products from April 2012 and June 2008 respectively. The radar is a C-band (5.3 cm wavelength) radar and data are received by the Nimrod system at 5 minute intervals.",
    "keywords": "Met Office, NIMROD, rain radar",
    "publicationState": "published",
    "dataPublishedTime": "2008-08-04T15:59:15",
    "doiPublishedTime": null,
    "updateFrequency": "continual",
    "status": "ongoing",
    "result_field": {
        "ob_id": "https://api.catalogue.ceda.ac.uk/api/v2/observations/5729/?format=api",
        "dataPath": "/badc/ukmo-nimrod/data/single-site/clee-hill/raw-polar/",
        "oldDataPath": [],
        "storageLocation": "internal",
        "storageStatus": "online",
        "volume": 769927814092,
        "numberOfFiles": 3497,
        "fileFormat": "NIMROD product data are in the non-standard NIMROD binary format. Refer to linked documentation for further details."
    },
    "timePeriod": "https://api.catalogue.ceda.ac.uk/api/v2/times/3290/?format=api",
    "geographicExtent": "https://api.catalogue.ceda.ac.uk/api/v2/bboxes/123/?format=api",
    "nonGeographicFlag": false,
    "phenomena": [
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/25899/?format=api"
    ],
    "dataLineage": "Data are acquired from rain radar network in the UK and Europe by the Met Office's NIMROD system. Composite products (images and data) and single site data are then sent to the BADC by the Met Office's DART operational dissemination system. Raw polar data from single sites are sent through from the RADARNET team at the Met Office. On arrival at the BADC the data are ingested after a one day quarantine.",
    "removedDataTime": null,
    "removedDataReason": "",
    "language": "English",
    "identifier_set": [
        "https://api.catalogue.ceda.ac.uk/api/v2/identifiers/3756/?format=api"
    ],
    "projects": [
        "https://api.catalogue.ceda.ac.uk/api/v2/projects/5736/?format=api"
    ],
    "observationcollection_set": [
        "https://api.catalogue.ceda.ac.uk/api/v2/observationcollections/5709/?format=api"
    ],
    "responsiblepartyinfo_set": [
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/24670/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/24675/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/24669/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/24672/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/24673/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/24674/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/24676/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/24671/?format=api"
    ],
    "procedureAcquisition": "https://api.catalogue.ceda.ac.uk/api/v2/acquisitions/5730/?format=api",
    "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"
        }
    ]
}