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

{
    "ob_id": 41670,
    "uuid": "81567bfb789e4ec4ae30cdd3772f8242",
    "title": "OpenCLIM - Catchment Flow Metrics",
    "abstract": "This dataset contains flood, drought, and flow metrics calculated as part of the OpenCLIM (Open CLimate Impacts Modelling framework) project. All metrics have been calculated for 698 UK catchments from timeseries of daily river flow simulated by the hydrological models SHETRAN and HBV by teams from Newcastle University and the University of East Anglia respectively for historical and future periods. All analysis code is available on GitHub (https://github.com/OpenCLIM/OpenCLIM-SHETRAN_Flow_Analysis).\r\n\r\nClimate change simulations were driven by bias corrected UKCP18 data from 01/12/1980 to 30/11/2080. Datasets from all 12 regional climate models (RCMs) were used and are presented separately. Flow metrics 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\nFile naming convention: Project_Data_Model_ClimateDriver_ScenarioNumber_ScenarioNote_Metric.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) adaptations applied. \r\nSc02 & Sc06: Land use was taken from baseline UDM setups with NFM max/moderate adaptations applied. \r\nSc03: Land use was taken from storylined UDM setups (2050 and 2080) for SSPs 2 and 4. No NFM adaptations were applied.  For SHETRAN, only catchments with UDM changes relative to the baseline simulations or the previous UDM year were simulated.\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\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,UDM,UKCP18",
    "publicationState": "citable",
    "dataPublishedTime": "2024-07-26T13:20:34",
    "doiPublishedTime": "2024-07-26T13:20:50.693127",
    "updateFrequency": "notPlanned",
    "status": "completed",
    "result_field": {
        "ob_id": "https://api.catalogue.ceda.ac.uk/api/v2/observations/42341/?format=api",
        "dataPath": "/badc/deposited2024/OpenCLIM_CatchmentFlowMetrics/",
        "oldDataPath": [],
        "storageLocation": "internal",
        "storageStatus": "online",
        "volume": 165172087,
        "numberOfFiles": 338,
        "fileFormat": "Data are BADC-CSV formatted."
    },
    "timePeriod": "https://api.catalogue.ceda.ac.uk/api/v2/times/11677/?format=api",
    "geographicExtent": "https://api.catalogue.ceda.ac.uk/api/v2/bboxes/4398/?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. These models generated river flows for historical and climate change simulations from which these metrics have been calculated.",
    "removedDataTime": null,
    "removedDataReason": "",
    "language": "English",
    "identifier_set": [
        "https://api.catalogue.ceda.ac.uk/api/v2/identifiers/13157/?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/203053/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/203054/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/203055/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/203056/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/203057/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/203058/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/203059/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/204117/?format=api"
    ],
    "procedureAcquisition": null,
    "procedureCompositeProcess": null,
    "procedureComputation": "https://api.catalogue.ceda.ac.uk/api/v2/computations/43043/?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": []
}