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

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

{
    "ob_id": 3711,
    "uuid": "19a10a2a96d55d689a039f35d646c833",
    "title": "ACSOE OXICOA EASE-96: Ground-based Atmospheric Oxidant Observations from the Mace Head Atmospheric Research Centre",
    "abstract": "The Atmospheric Chemistry Studies in the Oceanic Environment (ACSOE) was a 5-year Natural Environment Research Council (NERC) programme on tropospheric chemistry coordinated by the University of East Anglia and involving research groups from a number of UK universities and research institutes. The project had three consortia of UK institutes and universities, each of which focused on a different scientific topic. OXICOA (OXIdising Capacity of the Ocean Atmosphere) was a study of oxidant, radical and related gas-phase chemistry in the clean and moderately polluted marine atmosphere. The Eastern Atlantic Spring/Summer Experiments (EASE 96 and EASE 97) were carried to collect data. The dataset includes measurements of the OH and HO2 radicals, measurements of halogen oxide radicals at Mace Head in conjunction with a survey of potential organic halogen source gases. In EASE 96 the Cranfield Jetstream aircraft was deployed to measure the vertical and horizontal homogeneity of the air mass.",
    "keywords": "ACSOE, OXICOA, EASE, Tropospheric Chemistry",
    "publicationState": "published",
    "dataPublishedTime": "2007-03-24T21:44:49",
    "doiPublishedTime": null,
    "updateFrequency": "notPlanned",
    "status": "completed",
    "result_field": {
        "ob_id": "https://api.catalogue.ceda.ac.uk/api/v2/observations/12797/?format=api",
        "dataPath": "/badc/acsoe/data/ease-96/macehead/",
        "oldDataPath": [],
        "storageLocation": "internal",
        "storageStatus": "online",
        "volume": 14288054,
        "numberOfFiles": 368,
        "fileFormat": "The data files are NASA-Ames formatted."
    },
    "timePeriod": "https://api.catalogue.ceda.ac.uk/api/v2/times/3455/?format=api",
    "geographicExtent": "https://api.catalogue.ceda.ac.uk/api/v2/bboxes/508/?format=api",
    "nonGeographicFlag": false,
    "phenomena": [
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/79737/?format=api"
    ],
    "dataLineage": "Data collected by instruments on Mace Head Atmospheric Research Facility, Ireland. Data acquired by BADC for archiving as programme was underway.",
    "removedDataTime": null,
    "removedDataReason": "",
    "language": "English",
    "identifier_set": [
        "https://api.catalogue.ceda.ac.uk/api/v2/identifiers/2502/?format=api"
    ],
    "projects": [
        "https://api.catalogue.ceda.ac.uk/api/v2/projects/12801/?format=api"
    ],
    "observationcollection_set": [
        "https://api.catalogue.ceda.ac.uk/api/v2/observationcollections/3636/?format=api"
    ],
    "responsiblepartyinfo_set": [
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/48936/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/17080/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/17011/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/17016/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/17014/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/17015/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/17010/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/17012/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/48937/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/17017/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/17013/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/17018/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/17019/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/17020/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/17021/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/17022/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/17023/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/17025/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/17027/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/17028/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/17029/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/17032/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/17033/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/17035/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/17036/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/17038/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/17037/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/17039/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/17031/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/17040/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/17041/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/17043/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/17046/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/17045/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/17047/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/17049/?format=api"
    ],
    "procedureAcquisition": "https://api.catalogue.ceda.ac.uk/api/v2/acquisitions/3713/?format=api",
    "procedureCompositeProcess": null,
    "procedureComputation": null,
    "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"
        }
    ]
}