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

{
    "ob_id": 46129,
    "uuid": "92f8cee08d884d27a99397ae8a299f73",
    "title": "Climate model simulations of decadal-scale South Pacific Convergence Zone (SPCZ) rainfall using the Intermediate General Circulation Model version 4 (IGCM4)",
    "abstract": "This dataset contains outputs from modelling experiments using the Intermediate Global Circulation Model version 4 (IGCM4). The experiments use plausible scenarios of climate variability to simulate the processes driving South Pacific Convergence Zone (SPCZ) rainfall, and the decadal-scale SPCZ changes likely under different past and future modes of climate variability.\r\n\r\nDirectory names refer to the different experiments, in which perturbations were added onto sea surface temperatures corresponding to the: Atlantic Multidecadal Variability (A); Interdecadal Pacific Oscillation (I); and Southern Ocean (S). The numbers preceding each letter encode the size of the perturbation (see Skinner et al. for full details). For example, the directory 0A0I0S contains variables from the pre-industrial control experiment onto which no perturbations were added, while the directory 0A-3I0S contains variables from the experiment in which a three standard deviation magnitude negative IPO event was added onto the prescribed sea surface temperatures.\r\n\r\nEach experiment's directory contains the following daily data in netCDF format:\r\n- clouds.nc - Low, mid and high levels clouds\r\n- olr.nc - Outgoing longwave radiation\r\n- ppt.nc - Precipitation\r\n- tsfc.nc - Surface temperature\r\n- zg_500.nc - Geopotential height at 500 hPa\r\n- ta_250.nc - Air temperature at 250 hPa\r\n- ta_850.nc - Air temperature at 850 hPa\r\n- uwnd_250.nc - Zonal wind velocity at 250 hPa\r\n- uwnd_850.nc - Zonal wind velocity at 850 hPa\r\n- vwnd_250.nc - Meridional wind velocity at 250 hPa\r\n- vwnd_850.nc - Meridional wind velocity at 850 hPa\r\n\r\nThis dataset has two related publications:\r\n- Peaple et al. \"Ocean variability drives a millennial-scale shift in South Pacific hydroclimate.\" Communications Earth & Environment 6.1 (2025): 679. DOI: https://doi.org/10.1038/s43247-025-02676-5 (linked in the documentation section below)\r\n- Skinner et al. \"Decadal-scale drivers of South Pacific hydroclimate variability.\" Quarterly Journal of the Royal Meteorological Society. (2026 - UNDER REVIEW)\r\n\r\nThis dataset was produced as part of the Natural Environment Research Council (NERC) project Pacific Rainfall over Millennial Scales (PROMS) (grant reference: NE/W005565/1).",
    "keywords": "",
    "publicationState": "preview",
    "dataPublishedTime": null,
    "doiPublishedTime": null,
    "updateFrequency": "notPlanned",
    "status": "ongoing",
    "result_field": {
        "ob_id": "https://catalogue.ceda.ac.uk/api/v2/observations/46130/?format=api",
        "dataPath": "/badc/deposited2026/PROMS_IGCMmodel_output",
        "oldDataPath": [],
        "storageLocation": "internal",
        "storageStatus": "online",
        "volume": 122700535865,
        "numberOfFiles": 112,
        "fileFormat": "NetCDF"
    },
    "timePeriod": null,
    "geographicExtent": "https://catalogue.ceda.ac.uk/api/v2/bboxes/529/?format=api",
    "nonGeographicFlag": false,
    "phenomena": [
        "https://catalogue.ceda.ac.uk/api/v2/phenomona/1319/?format=api",
        "https://catalogue.ceda.ac.uk/api/v2/phenomona/1320/?format=api",
        "https://catalogue.ceda.ac.uk/api/v2/phenomona/6583/?format=api",
        "https://catalogue.ceda.ac.uk/api/v2/phenomona/28417/?format=api",
        "https://catalogue.ceda.ac.uk/api/v2/phenomona/70656/?format=api",
        "https://catalogue.ceda.ac.uk/api/v2/phenomona/70658/?format=api",
        "https://catalogue.ceda.ac.uk/api/v2/phenomona/70659/?format=api",
        "https://catalogue.ceda.ac.uk/api/v2/phenomona/70660/?format=api",
        "https://catalogue.ceda.ac.uk/api/v2/phenomona/70662/?format=api",
        "https://catalogue.ceda.ac.uk/api/v2/phenomona/93995/?format=api",
        "https://catalogue.ceda.ac.uk/api/v2/phenomona/93996/?format=api",
        "https://catalogue.ceda.ac.uk/api/v2/phenomona/93997/?format=api",
        "https://catalogue.ceda.ac.uk/api/v2/phenomona/93998/?format=api",
        "https://catalogue.ceda.ac.uk/api/v2/phenomona/93999/?format=api",
        "https://catalogue.ceda.ac.uk/api/v2/phenomona/94000/?format=api",
        "https://catalogue.ceda.ac.uk/api/v2/phenomona/94001/?format=api",
        "https://catalogue.ceda.ac.uk/api/v2/phenomona/94002/?format=api"
    ],
    "dataLineage": "Data were generated using the Intermediate General Circulation Model version 4 (IGCM4), data were saved in netCDF format and then submitted to CEDA for archiving.",
    "removedDataTime": null,
    "removedDataReason": "",
    "language": "English",
    "identifier_set": [],
    "projects": [],
    "observationcollection_set": [],
    "responsiblepartyinfo_set": [
        "https://catalogue.ceda.ac.uk/api/v2/rpis/220347/?format=api",
        "https://catalogue.ceda.ac.uk/api/v2/rpis/220348/?format=api",
        "https://catalogue.ceda.ac.uk/api/v2/rpis/220349/?format=api",
        "https://catalogue.ceda.ac.uk/api/v2/rpis/220350/?format=api",
        "https://catalogue.ceda.ac.uk/api/v2/rpis/220351/?format=api",
        "https://catalogue.ceda.ac.uk/api/v2/rpis/220352/?format=api",
        "https://catalogue.ceda.ac.uk/api/v2/rpis/220353/?format=api"
    ],
    "procedureAcquisition": null,
    "procedureCompositeProcess": null,
    "procedureComputation": null,
    "permissions": [
        {
            "ob_id": "https://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, attribution required"
        }
    ],
    "discoveryKeywords": []
}