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

{
    "ob_id": 43217,
    "uuid": "10ae416c4ccb4a90bdb5da0bbf68d4f9",
    "title": "Water tracer precipitation output from the Met Office Unified Model (GAL9.0) for 1985-2014",
    "abstract": "This dataset contains global water tracer precipitation from a historical simulation of the Met Office Unified Model (UM) for the 30 year period, 1985 to 2014.  The water tracer data can be used to track the source evaporative properties of the model's precipitation and is used in the following paper:\r\n\r\nMcLaren, A. J., Sime, L. C., Wilson, S., Ridley, J., Gao, Q., Gorguner, M., Line, G., Werner, M., and Valdes, P.: Implementation of water tracers in the Met Office Unified Model, Geosci. Model Dev., 18, 8129-8142, https://doi.org/10.5194/gmd-18-8129-2025, 2025.\r\n\r\nThe simulation is atmosphere only, with prescribed sea surface temperature and sea ice starting in 1979.  The ‘N96’ horizontal resolution version of the UM is used which has 192 longitude points by 144 latitude points, with a mid-latitude resolution of 135km.  There are 85 vertical levels with 50 levels below 18km and a fixed model lid at 85km above sea level.  The scientific configuration is GAL9.0 and the UM version is 13.3.   \r\n\r\nIn the dataset, the different water tracers have an associated 'water tracer number'.  These are:\r\n1 = Total precipitation\r\n2 = Precipitation that has been sourced from Northern Hemisphere (NH) sea ice sublimation\r\n3 = Precipitation that has been sourced from Southern Hemisphere (SH) sea ice sublimation\r\n4 = Precipitation that has been sourced from NH open ocean evaporation\r\n5 = Precipitation that has been sourced from SH open ocean evaporation\r\n6 = Precipitation that has been sourced from NH land evapotranspiration\r\n7 = Precipitation that has been sourced from SH (north of 60S) land evapotranspiration\r\n8 = Precipitation that has been sourced from SH (south of 60S) land evapotranspiration\r\n9-23 = Scaled flux water tracer precipitation  (see McLaren et al. 2025 for details)\r\nThese are fully documented in McLaren et al. (2025). \r\nGlobal climatological seasonal means for the 30 year period, 1985 - 2014,  are provided.",
    "keywords": "Water tracer, Precipitation",
    "publicationState": "citable",
    "dataPublishedTime": "2025-01-23T14:20:42",
    "doiPublishedTime": "2025-06-10T08:01:24",
    "updateFrequency": "notPlanned",
    "status": "completed",
    "result_field": {
        "ob_id": "https://api.catalogue.ceda.ac.uk/api/v2/observations/43375/?format=api",
        "dataPath": "/badc/deposited2025/UM_water_tracer_precip",
        "oldDataPath": [],
        "storageLocation": "internal",
        "storageStatus": "online",
        "volume": 10195197,
        "numberOfFiles": 2,
        "fileFormat": "Data is NetCDF formatted"
    },
    "timePeriod": "https://api.catalogue.ceda.ac.uk/api/v2/times/11913/?format=api",
    "geographicExtent": "https://api.catalogue.ceda.ac.uk/api/v2/bboxes/4597/?format=api",
    "nonGeographicFlag": false,
    "phenomena": [
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/19039/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/19043/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/49490/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/51186/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/51187/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/54871/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/62353/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/66241/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/70607/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/70608/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/74969/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/74970/?format=api"
    ],
    "dataLineage": "Monthly mean water tracer precipitation was output from the Met Office UM simulation.  This was then used to calculate the 30-year seasonal mean data using the Python package Iris by the project team before uploading to CEDA.",
    "removedDataTime": null,
    "removedDataReason": "",
    "language": "English",
    "identifier_set": [
        "https://api.catalogue.ceda.ac.uk/api/v2/identifiers/13415/?format=api"
    ],
    "projects": [
        "https://api.catalogue.ceda.ac.uk/api/v2/projects/43220/?format=api"
    ],
    "observationcollection_set": [],
    "responsiblepartyinfo_set": [
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/206405/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/205549/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/205550/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/205551/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/205552/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/205553/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/205554/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/205576/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/205577/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/205578/?format=api"
    ],
    "procedureAcquisition": null,
    "procedureCompositeProcess": null,
    "procedureComputation": "https://api.catalogue.ceda.ac.uk/api/v2/computations/43218/?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": []
}