GET

Observation Instance

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

{
    "ob_id": 41555,
    "uuid": "cf66055440344d7eb9b6f834e81736c6",
    "title": "CS-NOW: Gridded future projections of natural and artificially influenced river flows (1980 to 2080)",
    "abstract": "The Grid-to-Grid (G2G) river flow model projections comprise an ensemble of natural and artificially influenced (AI) estimates of daily mean river flows (m3s-1). These flow projections are for a historical and future period spanning 1st December 1980 to 30th November 2080 and reflect scenarios of change in both climate and artificial (anthropogenic) influences (abstractions and discharges).\r\nThe historical and future projections are available in two formats: \r\n(i) 1 km × 1 km gridded daily mean river flows (m3s-1) for two spatial regions: Natural river flows across  Great Britain, and Artificially influenced river flows across England\r\n(ii) Time series of daily flows for 626 catchments across England\r\nThe climate projections consist of an ensemble of bias-corrected UKCP18 Regional Climate Model (RCM) output. A further 4 hydrological connectivity datasets provide flow directions, upstream areas and coastal/gauged locations. Further details are provided in a linked Data Document.\r\n\r\n Three future scenarios of artificial influences are considered: \r\n(a) Sustainability (SUS), \r\n(b) Business as usual (BAU) and \r\n(c) Economic Growth (EG).  \r\n\r\nThe dataset is an output  from the CS-NOW project (Climate services for a Net Zero resilient world - GOV.UK (www.gov.uk)) commissioned by the UK Department for Energy Security and Net Zero (DESNZ).  Publication of these data is also supported by the Natural Environment Research Council award number NE/X019063/1 as part of the Hydro-JULES programme delivering National Capability.",
    "keywords": "Hydrology,Modelling,Daily River Flows,Abstractions,Discharges,Artificial Influences,UKCP18,Climate Projection,UK,CS-N0W,CS-NOW,Natural River Flows,Artificially Influenced River Flows",
    "publicationState": "citable",
    "dataPublishedTime": "2025-01-22T16:35:05",
    "doiPublishedTime": "2025-01-23T14:25:57",
    "updateFrequency": "notPlanned",
    "status": "completed",
    "result_field": {
        "ob_id": "https://api.catalogue.ceda.ac.uk/api/v2/observations/43319/?format=api",
        "dataPath": "/badc/desnz-cs-now/data/gridded-proj-river-flows",
        "oldDataPath": [],
        "storageLocation": "internal",
        "storageStatus": "online",
        "volume": 420233173964,
        "numberOfFiles": 3195,
        "fileFormat": "NetCDF and BADC-CSV"
    },
    "timePeriod": "https://api.catalogue.ceda.ac.uk/api/v2/times/11929/?format=api",
    "geographicExtent": "https://api.catalogue.ceda.ac.uk/api/v2/bboxes/4615/?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/75160/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/75161/?format=api"
    ],
    "dataLineage": "This dataset comprise an ensemble of natural and artificially influenced (AI) estimates of daily mean river flows (m3s-1). These flow projections are for a historical and future period spanning 1st December 1980 to 30th November 2080 and reflect scenarios of change in both climate and artificial (anthropogenic) influences (abstractions and discharges).  Data were produced 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/13230/?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/206223/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/202504/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/202505/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/202506/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/202507/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/202508/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/202509/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/202658/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/202659/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/202660/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/202661/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/202662/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/202663/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/202664/?format=api"
    ],
    "procedureAcquisition": null,
    "procedureCompositeProcess": null,
    "procedureComputation": "https://api.catalogue.ceda.ac.uk/api/v2/computations/41580/?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": []
}