Observation Instance – Django REST framework

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/44927/?format=api

HTTP 200 OK
Allow: GET, HEAD, OPTIONS
Content-Type: application/json
Vary: Accept

{
    "ob_id": 44927,
    "uuid": "9e21b0880dbc4e65b0e448a7fd4ec53c",
    "title": "Supporting data and images for the CWVC EMERALD-2 Campaign 2002.",
    "abstract": "Supporting data and images for the second CWVC Egrett Microphysics Experiment, with Radiation, Lidar and Dynamics  (EMERALD-2) Campaign based in Darwin, Australia, during September 2002\r\n\r\nThe dataset contains photographs, plots, high resolution cloud radar data provided by the Australian Bureau of Meteorology and sonde data to support the aircraft measurements made for the CWVC EMERALD-2 Campaign. \r\n\r\nThe EMERALD projects were airborne measurement campaigns designed to study dynamical, microphysical and infra-red radiative properties of cirrus clouds, using both in-situ and remote measurement techniques.  The ARA Grob Egrett T520 aircraft which flew above the cirrus clouds looking down in conjunction with the ARA King Air aircraft below looking up. \r\n\r\nThese data are part of the NERC Clouds, Water Vapour and Climate (CWVC) programme.",
    "keywords": "CWVC, EMERALD",
    "publicationState": "published",
    "dataPublishedTime": "2026-01-14T16:15:23",
    "doiPublishedTime": null,
    "updateFrequency": "notPlanned",
    "status": "completed",
    "result_field": {
        "ob_id": "https://api.catalogue.ceda.ac.uk/api/v2/observations/44946/?format=api",
        "dataPath": "/badc/cwvc/data/EMERALD-restructured/EMERALD-2/IMAGES-PLOTS-RADAR-SONDES",
        "oldDataPath": [],
        "storageLocation": "internal",
        "storageStatus": "online",
        "volume": 440676267,
        "numberOfFiles": 2434,
        "fileFormat": "Various, ASCII"
    },
    "timePeriod": "https://api.catalogue.ceda.ac.uk/api/v2/times/12737/?format=api",
    "geographicExtent": "https://api.catalogue.ceda.ac.uk/api/v2/bboxes/4896/?format=api",
    "nonGeographicFlag": false,
    "phenomena": [],
    "dataLineage": "Data were collected by CWVC-EMERALD project team during November and December 2002. Jim Whiteway (University of Wales, Aberystwyth) supplied the dataset to the BADC in 2004.\r\nThe dataset was restructured, empty and duplicate files removed, and spaces removed from filenames by CEDA in 2025",
    "removedDataTime": null,
    "removedDataReason": "",
    "language": "English",
    "identifier_set": [],
    "projects": [
        "https://api.catalogue.ceda.ac.uk/api/v2/projects/868/?format=api"
    ],
    "observationcollection_set": [
        "https://api.catalogue.ceda.ac.uk/api/v2/observationcollections/2755/?format=api"
    ],
    "responsiblepartyinfo_set": [
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/215275/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/215276/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/215269/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/215270/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/215271/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/215272/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/215273/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/215274/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/215277/?format=api"
    ],
    "procedureAcquisition": "https://api.catalogue.ceda.ac.uk/api/v2/acquisitions/44940/?format=api",
    "procedureCompositeProcess": null,
    "procedureComputation": null,
    "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": []
}