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

{
    "ob_id": 26135,
    "uuid": "9dace73ad8654298aea626b8bde0a782",
    "title": "Optimised global monthly mean surface flux of ethane (2008-2014) produced using the INVICAT 4D-Var inverse model",
    "abstract": "This data file contains two sets of optimised global surface fluxes of ethane (C2H6), produced through variational inverse methods using the TOMCAT chemical transport model, and the INVICAT inverse transport model. Emissions were produced using an iterative method of optimisation, known as 4D-Var, which minimised the model-observation differences.\r\n\r\nThese surface fluxes are produced as monthly mean values on the (approximately) 5.6 degree horizontal model grid. The associated uncertainty for the flux from each gridcell is also included.  \r\n\r\nThe fluxes and uncertainties are global, and cover the period Jan 2008 - Dec 2014.\r\n \r\nThere are two alternative emissions sets, labelled EMIS_ALL and EMIS_ANTH, whilst the uncertainties are labelled ERROR_ALL and ERROR_ANTH, respectively. The two optimised emission estimates are produced through iterative minimisation of model-observation error in INVICAT. In all cases the observations are surface flask samples of ethane produced by by the National Oceanic and Atmospheric Administration’s Global Monitoring Division (NOAA GMD) and the University of Colorado’s Institute of Arctic and Alpine Research (INSTAAR). Whole air samples in flasks are collected weekly to bi-weekly at each site and C2H6 is measured using gas chromatography with a flame ionization detection method.\r\n  \r\nThe EMIS_ALL fluxes are produced through variation of all surface emission types (anthropogenic, biomass burning, oceanic and biospheric), whilst the EMIS_ANTH fluxes are produced by only allowing the surface anthropogenic emissions to vary, with prior estimates of other emission types then added back on.\r\n\r\nFlux and uncertainty units are kg(C2H6)/m2/s, and time units are days since January 1st 2008. These emissions show improved performance relative to independent observations when included in the TOMCAT model. Further details about the data can be found in the PDF documentation stored along side this data, as well as in Monks et al., 2018.",
    "keywords": "",
    "publicationState": "citable",
    "dataPublishedTime": "2018-06-01T15:23:36",
    "doiPublishedTime": null,
    "updateFrequency": "notPlanned",
    "status": "completed",
    "result_field": {
        "ob_id": "https://api.catalogue.ceda.ac.uk/api/v2/observations/26133/?format=api",
        "dataPath": "/badc/deposited2018/invicat/data",
        "oldDataPath": [],
        "storageLocation": "internal",
        "storageStatus": "online",
        "volume": 2767364,
        "numberOfFiles": 2,
        "fileFormat": "NetCDF"
    },
    "timePeriod": "https://api.catalogue.ceda.ac.uk/api/v2/times/7064/?format=api",
    "geographicExtent": "https://api.catalogue.ceda.ac.uk/api/v2/bboxes/529/?format=api",
    "nonGeographicFlag": false,
    "phenomena": [
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/1319/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/1320/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/4385/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/24201/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/24203/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/57658/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/57659/?format=api"
    ],
    "dataLineage": "Produced by C. Wilson using the INVICAT inverse model, developed at the University of Leeds, Leeds, UK.   INVICAT is based on the TOMCAT chemical transport model, which was developed by M. P. Chipperfield, also now at the University of Leeds.",
    "removedDataTime": null,
    "removedDataReason": "",
    "language": "English",
    "identifier_set": [
        "https://api.catalogue.ceda.ac.uk/api/v2/identifiers/9587/?format=api"
    ],
    "projects": [],
    "observationcollection_set": [],
    "responsiblepartyinfo_set": [
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/109361/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/109359/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/109360/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/109362/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/109363/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/109364/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/109351/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/109358/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/109352/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/109353/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/109354/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/109355/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/109356/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/109357/?format=api"
    ],
    "procedureAcquisition": null,
    "procedureCompositeProcess": null,
    "procedureComputation": "https://api.catalogue.ceda.ac.uk/api/v2/computations/26134/?format=api",
    "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"
        }
    ]
}