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

{
    "ob_id": 45968,
    "uuid": "e020b3328b064b76898bb6e25b7b78d5",
    "title": "TOMCAT (VSLS): Sources and Impacts of Short-Lived Anthropogenic Chlorine",
    "abstract": "The TOMCAT 3D offline chemical transport model is designed to represent the complex interactions between atmospheric chemistry, dynamics, and transport. Simulation is performed using external meteorological reanalysis fields (ERA5) for January 1977 to March 2025. The model simulates the evolution of chemical species by integrating time-varying emissions, solar fluxes, and stratospheric aerosol data. By utilizing predefined scenarios, such as the WMO 2022 projections, the TOMCAT model provides a consistent framework for investigating how short-lived substances and ozone-depleting gases influence stratospheric composition and climate feedback mechanisms over decadal timescales.\r\n\r\nThe data are pre-processed (zonal mean monthly mean on pressure and height levels).",
    "keywords": "VSLS,CTM,Stratosphere",
    "publicationState": "preview",
    "dataPublishedTime": null,
    "doiPublishedTime": null,
    "updateFrequency": "notPlanned",
    "status": "pending",
    "result_field": {
        "ob_id": "https://catalogue.ceda.ac.uk/api/v2/observations/45997/?format=api",
        "dataPath": "/badc/deposited2026/TOMCAT_chlorine/",
        "oldDataPath": [],
        "storageLocation": "internal",
        "storageStatus": "online",
        "volume": 694967809,
        "numberOfFiles": 131,
        "fileFormat": "NetCDF"
    },
    "timePeriod": "https://catalogue.ceda.ac.uk/api/v2/times/13207/?format=api",
    "geographicExtent": null,
    "nonGeographicFlag": true,
    "phenomena": [
        "https://catalogue.ceda.ac.uk/api/v2/phenomona/50559/?format=api",
        "https://catalogue.ceda.ac.uk/api/v2/phenomona/60438/?format=api",
        "https://catalogue.ceda.ac.uk/api/v2/phenomona/93440/?format=api",
        "https://catalogue.ceda.ac.uk/api/v2/phenomona/93441/?format=api",
        "https://catalogue.ceda.ac.uk/api/v2/phenomona/93442/?format=api",
        "https://catalogue.ceda.ac.uk/api/v2/phenomona/93443/?format=api",
        "https://catalogue.ceda.ac.uk/api/v2/phenomona/93444/?format=api",
        "https://catalogue.ceda.ac.uk/api/v2/phenomona/93445/?format=api",
        "https://catalogue.ceda.ac.uk/api/v2/phenomona/93446/?format=api",
        "https://catalogue.ceda.ac.uk/api/v2/phenomona/93447/?format=api",
        "https://catalogue.ceda.ac.uk/api/v2/phenomona/93448/?format=api",
        "https://catalogue.ceda.ac.uk/api/v2/phenomona/93449/?format=api",
        "https://catalogue.ceda.ac.uk/api/v2/phenomona/93450/?format=api",
        "https://catalogue.ceda.ac.uk/api/v2/phenomona/93451/?format=api",
        "https://catalogue.ceda.ac.uk/api/v2/phenomona/93452/?format=api",
        "https://catalogue.ceda.ac.uk/api/v2/phenomona/93453/?format=api",
        "https://catalogue.ceda.ac.uk/api/v2/phenomona/93454/?format=api",
        "https://catalogue.ceda.ac.uk/api/v2/phenomona/93455/?format=api",
        "https://catalogue.ceda.ac.uk/api/v2/phenomona/93456/?format=api",
        "https://catalogue.ceda.ac.uk/api/v2/phenomona/93457/?format=api",
        "https://catalogue.ceda.ac.uk/api/v2/phenomona/93458/?format=api",
        "https://catalogue.ceda.ac.uk/api/v2/phenomona/93459/?format=api",
        "https://catalogue.ceda.ac.uk/api/v2/phenomona/93460/?format=api",
        "https://catalogue.ceda.ac.uk/api/v2/phenomona/93461/?format=api",
        "https://catalogue.ceda.ac.uk/api/v2/phenomona/93462/?format=api",
        "https://catalogue.ceda.ac.uk/api/v2/phenomona/93463/?format=api",
        "https://catalogue.ceda.ac.uk/api/v2/phenomona/93464/?format=api",
        "https://catalogue.ceda.ac.uk/api/v2/phenomona/93465/?format=api",
        "https://catalogue.ceda.ac.uk/api/v2/phenomona/93466/?format=api",
        "https://catalogue.ceda.ac.uk/api/v2/phenomona/93467/?format=api",
        "https://catalogue.ceda.ac.uk/api/v2/phenomona/93468/?format=api",
        "https://catalogue.ceda.ac.uk/api/v2/phenomona/93469/?format=api",
        "https://catalogue.ceda.ac.uk/api/v2/phenomona/93470/?format=api",
        "https://catalogue.ceda.ac.uk/api/v2/phenomona/93471/?format=api",
        "https://catalogue.ceda.ac.uk/api/v2/phenomona/93472/?format=api",
        "https://catalogue.ceda.ac.uk/api/v2/phenomona/93473/?format=api",
        "https://catalogue.ceda.ac.uk/api/v2/phenomona/93474/?format=api",
        "https://catalogue.ceda.ac.uk/api/v2/phenomona/93475/?format=api",
        "https://catalogue.ceda.ac.uk/api/v2/phenomona/93476/?format=api",
        "https://catalogue.ceda.ac.uk/api/v2/phenomona/93477/?format=api",
        "https://catalogue.ceda.ac.uk/api/v2/phenomona/93478/?format=api",
        "https://catalogue.ceda.ac.uk/api/v2/phenomona/93479/?format=api",
        "https://catalogue.ceda.ac.uk/api/v2/phenomona/93480/?format=api",
        "https://catalogue.ceda.ac.uk/api/v2/phenomona/93481/?format=api",
        "https://catalogue.ceda.ac.uk/api/v2/phenomona/93482/?format=api",
        "https://catalogue.ceda.ac.uk/api/v2/phenomona/93483/?format=api",
        "https://catalogue.ceda.ac.uk/api/v2/phenomona/93484/?format=api",
        "https://catalogue.ceda.ac.uk/api/v2/phenomona/93485/?format=api",
        "https://catalogue.ceda.ac.uk/api/v2/phenomona/93486/?format=api",
        "https://catalogue.ceda.ac.uk/api/v2/phenomona/93487/?format=api",
        "https://catalogue.ceda.ac.uk/api/v2/phenomona/93488/?format=api",
        "https://catalogue.ceda.ac.uk/api/v2/phenomona/93489/?format=api",
        "https://catalogue.ceda.ac.uk/api/v2/phenomona/93490/?format=api",
        "https://catalogue.ceda.ac.uk/api/v2/phenomona/93491/?format=api",
        "https://catalogue.ceda.ac.uk/api/v2/phenomona/93492/?format=api",
        "https://catalogue.ceda.ac.uk/api/v2/phenomona/93493/?format=api",
        "https://catalogue.ceda.ac.uk/api/v2/phenomona/93494/?format=api",
        "https://catalogue.ceda.ac.uk/api/v2/phenomona/93495/?format=api",
        "https://catalogue.ceda.ac.uk/api/v2/phenomona/93496/?format=api",
        "https://catalogue.ceda.ac.uk/api/v2/phenomona/93497/?format=api",
        "https://catalogue.ceda.ac.uk/api/v2/phenomona/93498/?format=api",
        "https://catalogue.ceda.ac.uk/api/v2/phenomona/93499/?format=api",
        "https://catalogue.ceda.ac.uk/api/v2/phenomona/93500/?format=api",
        "https://catalogue.ceda.ac.uk/api/v2/phenomona/93501/?format=api",
        "https://catalogue.ceda.ac.uk/api/v2/phenomona/93502/?format=api",
        "https://catalogue.ceda.ac.uk/api/v2/phenomona/93503/?format=api",
        "https://catalogue.ceda.ac.uk/api/v2/phenomona/93504/?format=api",
        "https://catalogue.ceda.ac.uk/api/v2/phenomona/93505/?format=api",
        "https://catalogue.ceda.ac.uk/api/v2/phenomona/93506/?format=api",
        "https://catalogue.ceda.ac.uk/api/v2/phenomona/93507/?format=api",
        "https://catalogue.ceda.ac.uk/api/v2/phenomona/93508/?format=api",
        "https://catalogue.ceda.ac.uk/api/v2/phenomona/93509/?format=api",
        "https://catalogue.ceda.ac.uk/api/v2/phenomona/93510/?format=api",
        "https://catalogue.ceda.ac.uk/api/v2/phenomona/93511/?format=api",
        "https://catalogue.ceda.ac.uk/api/v2/phenomona/93512/?format=api",
        "https://catalogue.ceda.ac.uk/api/v2/phenomona/93513/?format=api",
        "https://catalogue.ceda.ac.uk/api/v2/phenomona/93514/?format=api",
        "https://catalogue.ceda.ac.uk/api/v2/phenomona/93515/?format=api"
    ],
    "dataLineage": "The TOMCAT simulation data is from the RUN781 experiment, which was performed on the ARCHER/ARCHER2 supercomputing facilities using the TOMCAT three-dimensional chemical transport model to investigate the impact of short-lived anthropogenic chlorine on the stratosphere. Before being archived at the Centre for Environmental Data Analysis (CEDA), the raw model output underwent a systematic post-processing.  Specific tracer was extracted from the model output file, then it was interpolated from native model vertical grid levels onto a common set of pressure (1000 to 0.1 hPa) and geometric height (1 to 60 km) coordinates, and performing zonal averaging over longitude. Finally, the data was converted into NetCDF format.",
    "removedDataTime": null,
    "removedDataReason": "",
    "language": "English",
    "identifier_set": [],
    "projects": [
        "https://catalogue.ceda.ac.uk/api/v2/projects/45969/?format=api"
    ],
    "observationcollection_set": [],
    "responsiblepartyinfo_set": [
        "https://catalogue.ceda.ac.uk/api/v2/rpis/219675/?format=api",
        "https://catalogue.ceda.ac.uk/api/v2/rpis/219676/?format=api",
        "https://catalogue.ceda.ac.uk/api/v2/rpis/219677/?format=api",
        "https://catalogue.ceda.ac.uk/api/v2/rpis/219678/?format=api",
        "https://catalogue.ceda.ac.uk/api/v2/rpis/219679/?format=api",
        "https://catalogue.ceda.ac.uk/api/v2/rpis/219680/?format=api",
        "https://catalogue.ceda.ac.uk/api/v2/rpis/219681/?format=api",
        "https://catalogue.ceda.ac.uk/api/v2/rpis/219682/?format=api",
        "https://catalogue.ceda.ac.uk/api/v2/rpis/219683/?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": []
}