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/4951/?format=api
HTTP 200 OK
Allow: GET, HEAD, OPTIONS
Content-Type: application/json
Vary: Accept

{
    "ob_id": 4951,
    "uuid": "0ccf999ccfeda664fbd2a950af3a0581",
    "title": "QUEST-GSI: Aquatic Vulnerability Analysis model data",
    "abstract": "The QUEST-GSI WP-I5 \"Aquatic Ecosystems\" project provided an analysis of global fisheries vulnerability across a range of global climate models, emissions scenarios, fixed degree scenarios and alternative impact metrics. \r\n\r\nThis dataset contains model output data from the emission, fixed degree, Cheung potential analysis, Allison socio-economic comparison and freshwater run-off analysis scenarios. \r\n\r\n-Emission Scenarios-\r\nThese results are from the analysis using the SRES emissions scenarios from the IPCC AR4 - A1b, A2, B1 and B2.\r\n\r\n-Fixed Degree-\r\nThis analysis was driven by the fixed degree rise scenarios, corresponding to a fixed increase in global temperature by 2050. These are 1 to 4 degrees C, in half degree increments, with each fishery impact equally weighted across freshwater, EEZ and High Seas (see report). They are also carried out for a variety of GCMs and socio-economic scenarios.\r\n\r\n-Cheung Potential Catch Analysis-\r\nThese results were generated for marine fisheries using an alternative metric to temperature change in calculating potential impact- that of predicted change in potential catch from the study carried out by W.W.L. Cheung et al. (2009 Large-scale redistribution of maximum fisheries catch potential in the global ocean under climate change. Global Change Biology 16, 24-35). This was carried out for the A1b SRES scenario using the GFDL CM2.1 global climate model.\r\n\r\n-Allison Socio-economic comparison-\r\nA comparison study using the adaptive capacity metric developed in Allison et al. (2009 Vulnerability of national economies to the impacts of climate change on fisheries. Fish and Fisheries 10, 173–196). This was undertaken for the A1b Emission Scenario using HadCM3.\r\n\r\n-Freshwater Runoff Analysis-\r\nUsing predicted changes in freshwater availability from the outputs of QUEST-GSI WP-I1 global water resources project, an alternative analysis for freshwater fisheries vulnerability was carried out. This was under the 2 degrees fixed increase scenario using HadCM3.",
    "keywords": " QUEST, GSI, climate change, aquatic, run off",
    "publicationState": "published",
    "dataPublishedTime": "2014-09-21T20:44:44",
    "doiPublishedTime": null,
    "updateFrequency": "",
    "status": "completed",
    "result_field": {
        "ob_id": "https://api.catalogue.ceda.ac.uk/api/v2/observations/4952/?format=api",
        "dataPath": "/badc/quest/data/qgsi/wp_i5_aquatic_ecosystems",
        "oldDataPath": [],
        "storageLocation": "internal",
        "storageStatus": "online",
        "volume": 20842967,
        "numberOfFiles": 2295,
        "fileFormat": "Data are ASCII and CSV formatted"
    },
    "timePeriod": "https://api.catalogue.ceda.ac.uk/api/v2/times/4993/?format=api",
    "geographicExtent": "https://api.catalogue.ceda.ac.uk/api/v2/bboxes/1/?format=api",
    "nonGeographicFlag": false,
    "phenomena": [],
    "dataLineage": "Data provided by Nigel Arnell (University of Reading) for archiving at the BADC.",
    "removedDataTime": null,
    "removedDataReason": "",
    "language": "English",
    "identifier_set": [
        "https://api.catalogue.ceda.ac.uk/api/v2/identifiers/3287/?format=api"
    ],
    "projects": [
        "https://api.catalogue.ceda.ac.uk/api/v2/projects/12004/?format=api"
    ],
    "observationcollection_set": [
        "https://api.catalogue.ceda.ac.uk/api/v2/observationcollections/4950/?format=api"
    ],
    "responsiblepartyinfo_set": [
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/22325/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/22323/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/22326/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/22327/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/22328/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/22329/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/72553/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/22324/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/72554/?format=api"
    ],
    "procedureAcquisition": null,
    "procedureCompositeProcess": "https://api.catalogue.ceda.ac.uk/api/v2/composites/19058/?format=api",
    "procedureComputation": null,
    "permissions": [
        {
            "ob_id": "https://api.catalogue.ceda.ac.uk/api/v2/observations/2543/?format=api",
            "useLimitation": null,
            "accessConstraints": null,
            "accessCategory": "registered",
            "accessRoles": null,
            "label": "registered: None group",
            "licenceURL": "https://artefacts.ceda.ac.uk/licences/missing_licence.pdf",
            "licenceClassifications": "unstated"
        }
    ],
    "discoveryKeywords": [
        {
            "ob_id": 1138,
            "name": "NDGO0003"
        }
    ]
}