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

{
    "ob_id": 39570,
    "uuid": "a0b47bc07a8a4b628a463960eb2c161b",
    "title": "RisesAM-Global-clim: Hourly 1° global simulations of Ocean sea surface waves (climatological forcing based on 1970-2100) for 2 climate futures",
    "abstract": "This dataset covers the world ocean and it run for 2 climate futures. The climate projections (1970-2100) are forced by EC-Earth (https://ec-earth.org/) The data are produced with a spectral wave model; WaveWatchIII (Tolman, 1997) on a regular lat/lon grid with resolution is around 0.8 degrees. The netcdf data include high frequency (hourly) wave data of bulk parameters representing significant wave height, mean wave direction, and energy period. Partitioned wave data are also included for significant wave height, peak period, and direction. These data are presented in 3 partitions, with a fraction of wind sea specified for each. There are 2 different climate futures explored; RCP8.5 and RCP4.5 (regional concentration pathways). The two scenarios are driven by different Representative Concentration Pathways (RCPs). The RCPs, RCP4.5 and RCP8.5, are labelled after a possible range of radiative forcing values in the year 2100 relative to pre-industrial values (+4.5, and +8.5 W/m2, respectively). The data set is produced to benchmark the model before investigating future wave conditions under climate change. The simulations were run using funding from the European Union’s Seventh Programme for Research, Technological Development and Demonstration under Grant Agreement No: FP7-ENV-2013-Two-Stage-603396-RISES-AM-. This work used the ARCHER UK National Supercomputing Service (http://www.archer.ac.uk)",
    "keywords": "surface, model, wave, ERA, interim, reanalysis, UK, climate, projections, UKCP18",
    "publicationState": "citable",
    "dataPublishedTime": "2023-04-04T14:10:14",
    "doiPublishedTime": "2023-04-06T08:12:05",
    "updateFrequency": "notPlanned",
    "status": "completed",
    "result_field": {
        "ob_id": "https://api.catalogue.ceda.ac.uk/api/v2/observations/39571/?format=api",
        "dataPath": "/bodc/POL230027/RisesAM-OceanWaves/RisesAM-Global-clim",
        "oldDataPath": [],
        "storageLocation": "internal",
        "storageStatus": "online",
        "volume": 3083830878847,
        "numberOfFiles": 2701,
        "fileFormat": "Data are CF-Compliant NetCDF formatted data files"
    },
    "timePeriod": "https://api.catalogue.ceda.ac.uk/api/v2/times/10969/?format=api",
    "geographicExtent": "https://api.catalogue.ceda.ac.uk/api/v2/bboxes/3746/?format=api",
    "nonGeographicFlag": false,
    "phenomena": [
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/54763/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/54764/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/62612/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/62613/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/62614/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/62615/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/62616/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/62617/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/62618/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/62619/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/62620/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/62621/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/62622/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/62623/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/62624/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/62625/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/62626/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/62627/?format=api"
    ],
    "dataLineage": "This dataset consists of regional and global simulations of wave data under different climate futures. The simulations were funded through European Union’s Seventh Programme for Research, Technological Development, and Demonstration project FP7-ENV-2013-Two-Stage-603396-RISES-AM, and used the ARCHER UK National Supercomputing Service. The outputs are archived on the British Oceanographic Data Centre (BODC)'s space at the Centre for Environmental Data Analysis (CEDA) and assigned a DOI. No quality control procedures were applied by BODC.",
    "removedDataTime": null,
    "removedDataReason": "",
    "language": "English",
    "identifier_set": [
        "https://api.catalogue.ceda.ac.uk/api/v2/identifiers/12458/?format=api"
    ],
    "projects": [
        "https://api.catalogue.ceda.ac.uk/api/v2/projects/39562/?format=api"
    ],
    "observationcollection_set": [
        "https://api.catalogue.ceda.ac.uk/api/v2/observationcollections/39572/?format=api"
    ],
    "responsiblepartyinfo_set": [
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/192965/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/192966/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/192967/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/192963/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/192960/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/192962/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/192961/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/192964/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/192968/?format=api"
    ],
    "procedureAcquisition": null,
    "procedureCompositeProcess": null,
    "procedureComputation": "https://api.catalogue.ceda.ac.uk/api/v2/computations/39563/?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": []
}