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

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

{
    "ob_id": 3046,
    "uuid": "5c8d3edd7ebdfe0283b4e388258a27b2",
    "title": "COPS: vertical wind profiles from the University of Leeds Sodar no. 2 located at Archern, Germany.",
    "abstract": "The data were collected by a Doppler Sodar, operated by the University of Leeds, at Barongartenhuette near Enzklosterle, Germany. The data provided are 15 minute averages of backscatter, horizontal wind and vertical wind.\r\n\r\nThe dataset contains the following measurements:\r\nWind speed\r\nWind direction\r\nEastward wind\r\nBackscatter\r\nUpward air velocity\r\nHeight\r\nNorthward wind\r\n",
    "keywords": "COPS, Backscatter, Wind, temperature",
    "publicationState": "published",
    "dataPublishedTime": "2007-08-23T11:04:54",
    "doiPublishedTime": null,
    "updateFrequency": "notPlanned",
    "status": "completed",
    "result_field": {
        "ob_id": "https://api.catalogue.ceda.ac.uk/api/v2/observations/3047/?format=api",
        "dataPath": "/badc/cops/data/leeds-sodar2",
        "oldDataPath": [],
        "storageLocation": "internal",
        "storageStatus": "online",
        "volume": 30488997,
        "numberOfFiles": 66,
        "fileFormat": "The data are binary or ASCII formatted. "
    },
    "timePeriod": "https://api.catalogue.ceda.ac.uk/api/v2/times/818/?format=api",
    "geographicExtent": "https://api.catalogue.ceda.ac.uk/api/v2/bboxes/699/?format=api",
    "nonGeographicFlag": false,
    "phenomena": [
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/50416/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/52678/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/52679/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/52680/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/52681/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/52682/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/52683/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/52684/?format=api"
    ],
    "dataLineage": "Data were collected by the Facility for Airborne Atmospheric Measurements (FAAM) aircraft and the deployment of a number of the UK Universities' Facility for Atmospheric Measurement (UFAM) mobile instruments in summer 2007.\r\nData were then prepared by project participants and then submitted to BADC for archiving.",
    "removedDataTime": null,
    "removedDataReason": "",
    "language": "English",
    "identifier_set": [
        "https://api.catalogue.ceda.ac.uk/api/v2/identifiers/2092/?format=api"
    ],
    "projects": [
        "https://api.catalogue.ceda.ac.uk/api/v2/projects/3036/?format=api"
    ],
    "observationcollection_set": [
        "https://api.catalogue.ceda.ac.uk/api/v2/observationcollections/3033/?format=api"
    ],
    "responsiblepartyinfo_set": [
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/13695/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/13701/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/13698/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/13699/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/42302/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/42305/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/13697/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/13696/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/42303/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/75352/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/42304/?format=api"
    ],
    "procedureAcquisition": "https://api.catalogue.ceda.ac.uk/api/v2/acquisitions/3050/?format=api",
    "procedureCompositeProcess": null,
    "procedureComputation": null,
    "permissions": [
        {
            "ob_id": "https://api.catalogue.ceda.ac.uk/api/v2/observations/2522/?format=api",
            "useLimitation": null,
            "accessConstraints": null,
            "accessCategory": "registered",
            "accessRoles": null,
            "label": "registered: None group",
            "licenceURL": "http://www.nationalarchives.gov.uk/doc/open-government-licence/version/3/",
            "licenceClassifications": "any"
        }
    ],
    "discoveryKeywords": [
        {
            "ob_id": 1138,
            "name": "NDGO0003"
        }
    ]
}