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

{
    "ob_id": 31992,
    "uuid": "4fa633d24d104217a4c9d3fb3589f35d",
    "title": "Obs4MIPs:   Monthly-mean diurnal cycle of top of atmosphere outgoing shortwave radiation from the GERB instrument (GERB-HR-ED01 rsut 1hrCM)",
    "abstract": "This dataset contains top of atmosphere (TOA) outgoing shortwave radiation from the Geostationary Earth Radiation Budget (GERB) instrument on board the Meteosat-9 geostationary satellite, for the period from May 2007 until 2012.   In this dataset (labelled 'GERB-HR-ED01 rsut 1hrCM'),  the data provided consist of monthly-mean diurnal cycles, with each day resolved into 1-hour means.    Data are only available for six months of each year (January, May, June, July, November and December), due to operational constraints of the GERB instrument.    \r\n\r\nIt has been produced in Obs4MIPs (Observations for Model Intercomparisons Project) format, as part of an activity to increase the use of GERB satellite observational data for the modelling and model analysis communities. This is not currently a standard GERB satellite instrument product, but does represent an effort on behalf of the GERB project team to identify a product that is appropriate for routine model evaluation. The data may have been reprocessed, reformatted, or created solely for comparisons with climate model output.",
    "keywords": "Obs4MIPS, GERB, TOA outgoing shortwave radiation",
    "publicationState": "citable",
    "dataPublishedTime": "2021-03-09T16:46:07",
    "doiPublishedTime": "2021-04-29T15:36:40",
    "updateFrequency": "notPlanned",
    "status": "ongoing",
    "result_field": {
        "ob_id": "https://api.catalogue.ceda.ac.uk/api/v2/observations/31995/?format=api",
        "dataPath": "/neodc/obs4MIPs/ImperialCollege/GERB-HR-ED01-1-0/1hrCM/rsut/gn/v20200506/",
        "oldDataPath": [],
        "storageLocation": "internal",
        "storageStatus": "online",
        "volume": 448035473,
        "numberOfFiles": 7,
        "fileFormat": "Data are in NetCDF format"
    },
    "timePeriod": "https://api.catalogue.ceda.ac.uk/api/v2/times/8778/?format=api",
    "geographicExtent": "https://api.catalogue.ceda.ac.uk/api/v2/bboxes/2720/?format=api",
    "nonGeographicFlag": false,
    "phenomena": [
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/6021/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/6022/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/19461/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/50415/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/50417/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/50555/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/60438/?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/10861/?format=api"
    ],
    "projects": [],
    "observationcollection_set": [
        "https://api.catalogue.ceda.ac.uk/api/v2/observationcollections/32223/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/observationcollections/30127/?format=api"
    ],
    "responsiblepartyinfo_set": [
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/141668/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/141671/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/141666/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/141669/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/141670/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/141672/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/141665/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/141667/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/141673/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/141674/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/141675/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/143703/?format=api"
    ],
    "procedureAcquisition": null,
    "procedureCompositeProcess": "https://api.catalogue.ceda.ac.uk/api/v2/composites/31994/?format=api",
    "procedureComputation": null,
    "permissions": [
        {
            "ob_id": "https://api.catalogue.ceda.ac.uk/api/v2/observations/2528/?format=api",
            "useLimitation": null,
            "accessConstraints": null,
            "accessCategory": "public",
            "accessRoles": null,
            "label": "public: None group",
            "licenceURL": "http://creativecommons.org/licenses/by/4.0/",
            "licenceClassifications": "any"
        }
    ],
    "discoveryKeywords": [
        {
            "ob_id": 1138,
            "name": "NDGO0003"
        }
    ]
}