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

{
    "ob_id": 41672,
    "uuid": "a2e1601a29004c13849be5e84594f37a",
    "title": "OpenCLIM: Catchment Discharges",
    "abstract": "This dataset contains simulated river flow discharges from the SHETRAN and HBV hydrological models used in the OpenCLIM (Open CLimate Impacts Modelling framework) project. All values are daily flows (i.e. flow at midnight on the given day) in cumecs. Flows are given for 698 catchments in the UK at catchment outlets/gauge locations: https://nrfa.ceh.ac.uk/data/search. These data can be used for the continued analysis of climate impacts and for comparison with future studies.\r\n\r\nHistorical simulations were driven by CHESS/GEAR (Great Britain) and HADUK-Grid (Northern Ireland) datasets from 01/01/1980 to 31/12/2010 (described below).\r\nClimate change simulations were driven by bias corrected UKCP18 data from from 01/12/1980 to 30/11/2080. \r\n\r\nFile naming convention: Project_Data_Model_ClimateDriver_ScenarioNumber_ScenarioNote_RCMNumber.csv\r\n\r\nScenario notes:\r\nSc01: Land use was taken from baseline Urban Development Model (UDM) setups with no Natural Flood Management (NFM) applied.\r\nSc02 & Sc06: Land use was taken from baseline UDM setups with maximum/moderate NFM were applied (increased woodland and storage). \r\nSc03: Land use was taken from storylined UDM setups (2050 and 2080) for SSPs 2 and 4. No NFM adaptations were applied. Only those (GB) catchments that have UDM changes relative to the baseline simulations or the previous UDM year are simulated.\r\n'RCM' refers to the UKCP18 Regional Climate Model time series that was used in the simulation.\r\n\r\nFurther information, including descriptions of the urban development model (UDM) and natural flood management (NFM) setups, is provided in the supplementary README.txt alongside the data.\r\n\r\nInput datasets:\r\nCHESS - The Climate hydrology and ecology research support system (CHESS) provides high-resolution gridded datasets for environmental research. These datasets include data for driving land surface models and hydrological models, as well as model output.\r\nGEAR - The Centre for Ecology & Hydrology – Gridded Estimates of Areal Rainfall (CEH-GEAR) data set was developed to provide reliable 1 km gridded estimates of daily and monthly rainfall for Great Britain (GB) and Northern Ireland (NI) from 1890 onwards. The data set was primarily required to support hydrological modelling.\r\nHadUK-Grid - HadUK-Grid is a collection of gridded climate variables derived from the network of UK land surface observations by the Met Office. \r\nUKCP18 - UK Climate Projections 2018 (UKCP18) is a climate analysis tool that forms part of the Met Office Hadley Centre Climate Programme.",
    "keywords": "SHETRAN,HBV,OpenCLIM,UKCP18,UDM,Discharge",
    "publicationState": "citable",
    "dataPublishedTime": "2024-07-26T13:10:29",
    "doiPublishedTime": "2024-07-26T13:11:00",
    "updateFrequency": "notPlanned",
    "status": "completed",
    "result_field": {
        "ob_id": "https://api.catalogue.ceda.ac.uk/api/v2/observations/41757/?format=api",
        "dataPath": "/badc/deposited2024/OpenCLIM_CatchmentDischarges/",
        "oldDataPath": [],
        "storageLocation": "internal",
        "storageStatus": "online",
        "volume": 15477974649,
        "numberOfFiles": 171,
        "fileFormat": "BADC-CSV"
    },
    "timePeriod": "https://api.catalogue.ceda.ac.uk/api/v2/times/11680/?format=api",
    "geographicExtent": "https://api.catalogue.ceda.ac.uk/api/v2/bboxes/4399/?format=api",
    "nonGeographicFlag": false,
    "phenomena": [],
    "dataLineage": "Hydrological models were run for 698 catchments in the UK by teams at Newcastle university (SHETRAN) and University of East Anglia (HBV) as part of the OpenCLIM project.",
    "removedDataTime": null,
    "removedDataReason": "",
    "language": "English",
    "identifier_set": [
        "https://api.catalogue.ceda.ac.uk/api/v2/identifiers/13156/?format=api"
    ],
    "projects": [
        "https://api.catalogue.ceda.ac.uk/api/v2/projects/41636/?format=api"
    ],
    "observationcollection_set": [],
    "responsiblepartyinfo_set": [
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/204485/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/203062/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/203063/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/203064/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/203065/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/203066/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/203067/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/203061/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/203068/?format=api"
    ],
    "procedureAcquisition": null,
    "procedureCompositeProcess": null,
    "procedureComputation": "https://api.catalogue.ceda.ac.uk/api/v2/computations/43044/?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": []
}