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

{
    "ob_id": 32117,
    "uuid": "88224a922439441fa6644b4564dcd90c",
    "title": "Posterior South American monthly mean surface flux of methane (2010-2018) produced using the INVICAT 4D-Var inverse model.",
    "abstract": "This data set consist of a single file which contains a set of optimised global surface fluxes of methane (CH4), produced through variational inverse methods using the TOMCAT chemical transport model, and the INVICAT inverse transport model. These 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 grid cell is also included. The fluxes and uncertainties are global and cover the period Jan 2010 - Dec 2018. The emissions from fossil fuels are labelled FF_FLUX, whilst the uncertainties are labelled FF_ERROR. The emissions from natural, agricultural and biomass burning sources are labelled NAT_FLUX, whilst the uncertainties are labelled NAT_ERROR. These two sectors (fossil fuel and non-fossil fuel) are solved for separately in the inversion. Flux and uncertainty units are kg(CH4)/m2/s, and time units are days since January 1st 2010. These emissions show improved performance relative to independent observations when included in the TOMCAT model. Further details about the data can be found in Wilson et al. (2020) in the documentation section.",
    "keywords": "CH4, Methane, Amazon, agriculture, biomass, TOMCAT, INVICAT",
    "publicationState": "citable",
    "dataPublishedTime": "2021-02-11T16:07:17",
    "doiPublishedTime": "2021-02-17T14:19:15.290225",
    "updateFrequency": "",
    "status": "completed",
    "result_field": {
        "ob_id": "https://api.catalogue.ceda.ac.uk/api/v2/observations/32118/?format=api",
        "dataPath": "/neodc/gosat/data/ch4/invicat_amazon/v1.0/",
        "oldDataPath": [],
        "storageLocation": "internal",
        "storageStatus": "online",
        "volume": 293715,
        "numberOfFiles": 2,
        "fileFormat": "NetCDF"
    },
    "timePeriod": "https://api.catalogue.ceda.ac.uk/api/v2/times/8808/?format=api",
    "geographicExtent": "https://api.catalogue.ceda.ac.uk/api/v2/bboxes/2725/?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/68846/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/68847/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/68848/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/68849/?format=api"
    ],
    "dataLineage": "Data were produced by the project team and supplied for archiving at the Centre for Environmental Data Analysis (CEDA).",
    "removedDataTime": null,
    "removedDataReason": "",
    "language": "English",
    "identifier_set": [
        "https://api.catalogue.ceda.ac.uk/api/v2/identifiers/10804/?format=api"
    ],
    "projects": [
        "https://api.catalogue.ceda.ac.uk/api/v2/projects/5002/?format=api"
    ],
    "observationcollection_set": [
        "https://api.catalogue.ceda.ac.uk/api/v2/observationcollections/30127/?format=api"
    ],
    "responsiblepartyinfo_set": [
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/142458/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/142456/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/142457/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/142459/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/142460/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/142492/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/142493/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/142455/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/142494/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/142495/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/142496/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/142497/?format=api"
    ],
    "procedureAcquisition": null,
    "procedureCompositeProcess": null,
    "procedureComputation": "https://api.catalogue.ceda.ac.uk/api/v2/computations/32129/?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"
        }
    ]
}