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

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

{
    "ob_id": 44919,
    "uuid": "5b60369c5a444de1af5149a1968cbaa2",
    "title": "ARA Beech B200T Super King Air Aircraft measurements for the CWVC EMERALD-1 Campaign 2001.",
    "abstract": "In-situ and remote measurements made on the Airborne Research Australia (ARA) Beech B200T Super King Air Aircraft for the first CWVC Egrett Microphysics Experiment, with Radiation, Lidar and Dynamics (EMERALD-1) Campaign based in Adelaide, Australia, during September 2001 \r\nThe dataset contains static air temperature, static air pressure, relative humidity, water vapour mixing ratio, and ozone mixing ratio plus LiDAR measurements of the cirrus cloud made by the Aberystwyth vertical pointing depolarisation lidar system.\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 King Air aircraft flew below cirrus clouds looking up in conjunction with the ARA Grob Egrett T520 aircraft which flew above looking down. \r\n\r\nThese data are part of the NERC Clouds, Water Vapour and Climate (CWVC) programme.",
    "keywords": "CWVC, EMERALD, Ozone, LIDAR, DIAL",
    "publicationState": "published",
    "dataPublishedTime": "2026-01-14T16:15:53",
    "doiPublishedTime": null,
    "updateFrequency": "notPlanned",
    "status": "completed",
    "result_field": {
        "ob_id": "https://api.catalogue.ceda.ac.uk/api/v2/observations/44944/?format=api",
        "dataPath": "/badc/cwvc/data/EMERALD-restructured/EMERALD-1/KINGAIR-data",
        "oldDataPath": [],
        "storageLocation": "internal",
        "storageStatus": "online",
        "volume": 1389557946,
        "numberOfFiles": 51151,
        "fileFormat": "Various, ASCII"
    },
    "timePeriod": "https://api.catalogue.ceda.ac.uk/api/v2/times/12735/?format=api",
    "geographicExtent": "https://api.catalogue.ceda.ac.uk/api/v2/bboxes/4895/?format=api",
    "nonGeographicFlag": false,
    "phenomena": [],
    "dataLineage": "Data were collected by the Airborne Research Australia Beech B200T Super King Air aircraft based in Adelaide during September 2001. 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": [
        "https://api.catalogue.ceda.ac.uk/api/v2/identifiers/13571/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/identifiers/13572/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/identifiers/13573/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/identifiers/13582/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/identifiers/13583/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/identifiers/13584/?format=api"
    ],
    "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/215231/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/215230/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/215232/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/215233/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/215234/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/215236/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/215229/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/215235/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/215237/?format=api"
    ],
    "procedureAcquisition": "https://api.catalogue.ceda.ac.uk/api/v2/acquisitions/44920/?format=api",
    "procedureCompositeProcess": null,
    "procedureComputation": null,
    "permissions": [],
    "discoveryKeywords": []
}