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

{
    "ob_id": 43175,
    "uuid": "18886f95ba84447f997efac96df456ad",
    "title": "Gridded actual groundwater, surface water and tidal water abstraction, discharge and Hands-off Flow datasets for England (1999 to 2014)",
    "abstract": "This dataset contains recorded or ‘actual’ abstraction and discharge data for sites across England that have been transformed into 1 km × 1 km resolution gridded data along with surface water Hands-off Flow (HoF) conditions, and are available in CSV and/or NetCDF formats.  It includes:\r\n \r\n(i)\tMonthly abstractions (m3 month-1) from 1999 to 2014 for each source (Groundwater, Surface Water or Tidal Water)\r\n(ii)\tMean monthly abstractions (m3 month-1) over the period 2010 to 2014 for each source (Groundwater, Surface Water or Tidal Water)\r\n(iii)\tDaily rate of Consented Dry Weather flow (CDWF)and Recent Actual (RACT) discharges (m3 day-1) based on information from a 6-year period ending in 2017\r\n(iv)\tHands-off Flow (HoF) conditions (m3 day-1) for 2022\r\n\r\nFurther details, including caveats about usage, are provided in the linked Data Document.\r\n\r\nThese data were sourced from the Environment Agency (EA) monthly groundwater, surface water and tidal water abstraction data from 1999 to 2014, and annual discharges and surface water Hands-off Flow (HoF) conditions were obtained from the EA’s Water Resources Geographic Information System (WRGIS 2017 and 2022 versions respectively). \r\n\r\nThis data publication is supported by the Natural Environment Research Council award number NE/X019063/1 as part of the Hydro-JULES programme delivering National Capability. The dataset is also linked with the Climate Services for a Net Zero Resilient World (CS-N0W) project.",
    "keywords": "Abstractions,Discharges,Hands-off Flow,Artificial Influences,Groundwater,Surface Water,Tidal Water,Consented Dry Weather Flow,Recent Actual Discharges,CS-NOW,England,Hydrology,River Flows",
    "publicationState": "citable",
    "dataPublishedTime": "2025-01-22T16:37:23",
    "doiPublishedTime": "2025-01-23T14:24:36.200932",
    "updateFrequency": "notPlanned",
    "status": "completed",
    "result_field": {
        "ob_id": "https://api.catalogue.ceda.ac.uk/api/v2/observations/43320/?format=api",
        "dataPath": "/badc/desnz-cs-now/data/gridded-actual-flows",
        "oldDataPath": [],
        "storageLocation": "internal",
        "storageStatus": "online",
        "volume": 166445191,
        "numberOfFiles": 13,
        "fileFormat": "NetCDF and BADC-CSV"
    },
    "timePeriod": "https://api.catalogue.ceda.ac.uk/api/v2/times/11942/?format=api",
    "geographicExtent": "https://api.catalogue.ceda.ac.uk/api/v2/bboxes/4622/?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/24329/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/27830/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/27831/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/50559/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/50561/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/62546/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/74991/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/74992/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/74993/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/74994/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/74995/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/74996/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/74997/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/74998/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/74999/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/75000/?format=api"
    ],
    "dataLineage": "The abstraction and discharge datasets were sourced from the Environment Agency. Specifically, monthly groundwater, surface water and tidal water abstraction data were obtained from 1999 to 2014, and annual discharges and surface water Hands-off Flow (HoF) conditions were obtained from the EA’s Water Resources Geographic Information System (WRGIS 2017 and 2022 versions respectively). Due to national security data restrictions regarding the location of public water supply abstractions, publication of the dataset is limited to a 1 km x 1 km resolution. Information at a higher resolution has been removed or converted to a 1 km x 1 km resolution as appropriate, and any personal or identifying data has been removed.\r\n\r\nThese data were compiled by the project team before archival at EDS-CEDA",
    "removedDataTime": null,
    "removedDataReason": "",
    "language": "English",
    "identifier_set": [
        "https://api.catalogue.ceda.ac.uk/api/v2/identifiers/13229/?format=api"
    ],
    "projects": [
        "https://api.catalogue.ceda.ac.uk/api/v2/projects/41577/?format=api"
    ],
    "observationcollection_set": [],
    "responsiblepartyinfo_set": [
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/206222/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/205294/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/205295/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/205296/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/205297/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/205298/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/205299/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/205378/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/205379/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/205380/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/205381/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/205382/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/205383/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/205384/?format=api"
    ],
    "procedureAcquisition": null,
    "procedureCompositeProcess": null,
    "procedureComputation": "https://api.catalogue.ceda.ac.uk/api/v2/computations/43417/?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": []
}