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

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

{
    "ob_id": 44663,
    "uuid": "7fb87dfcc7af40f783dc181b2c0d3e6c",
    "title": "WesCon: Vertical wind profiles and backscatter measurements from the Met Office Halo Doppler Lidar unit 35 at Airfield Camp, Netheravon, v1.0 (20230426-20230918)",
    "abstract": "Vertical wind profiles and backscatter measurements from the Met Office Halo Doppler Lidar unit 35 deployed at Netheravon, Wiltshire (51.241°N, -1.777°W, 120 m amsl) in southern England during the summer of 2023. Netheravon formed a supersite for the Wessex Summertime Convection Experiment (WesCon)/WesCon - Observing the Evolving Structures of Turbulence (WOEST) field campaign. \r\nThe Halo lidar is based on a 1565 nm laser emitting linearly polarized pulsed light through an 8 cm diameter lens with a heterodyne detector. Laser beam returns from the atmosphere are range-gated velocity and back-scattered power. The Halo is capable of full hemispheric scanning of the backscatter coefficient and radial velocity as a function of beam range. \r\nThe usual operation was vertical stares (zenith angle=0°) with periodic wind scans that invoked various options of off-axis views. DBS (Doppler beam swinging) scans used a tri-axis azimuthally orthogonal technique using the single lidar beam to retrieve horizontal mean wind components every 30 mins. Multi-axis VAD (velocity azimuth display) scans are a more involved version of the DBS scans and used 12 point off-zenith views performed every 60 mins. The vertical stares, DBS and VAD wind scans produced separate archived netCDF files. \r\nAlthough depolarisation capability was possible with unit 35, this was switched off during WesCon.\r\n\r\nTo ensure optimal traceability and transparency of data, comprehensive metadata is included.",
    "keywords": "WesCon, Met Office, Doppler lidar, vertical stares, wind scans",
    "publicationState": "citable",
    "dataPublishedTime": "2025-08-07T08:19:03",
    "doiPublishedTime": "2025-08-07T09:44:53",
    "updateFrequency": "notPlanned",
    "status": "completed",
    "result_field": {
        "ob_id": "https://api.catalogue.ceda.ac.uk/api/v2/observations/44665/?format=api",
        "dataPath": "/badc/woest/data/metoffice-halo-lidar-35",
        "oldDataPath": [],
        "storageLocation": "internal",
        "storageStatus": "online",
        "volume": 55878847386,
        "numberOfFiles": 541,
        "fileFormat": "NetCDF"
    },
    "timePeriod": "https://api.catalogue.ceda.ac.uk/api/v2/times/12563/?format=api",
    "geographicExtent": "https://api.catalogue.ceda.ac.uk/api/v2/bboxes/4728/?format=api",
    "nonGeographicFlag": false,
    "phenomena": [
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/75764/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/75765/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/75766/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/75767/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/75768/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/75769/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/75770/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/75771/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/75772/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/75773/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/75774/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/75775/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/75776/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/75777/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/75778/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/75779/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/75780/?format=api"
    ],
    "dataLineage": "Data were processed and prepared by the Met Office instrument team before delivery to the NERC EDS Centre for Environmental Data Analysis (CEDA) for long term archival.",
    "removedDataTime": null,
    "removedDataReason": "",
    "language": "English",
    "identifier_set": [
        "https://api.catalogue.ceda.ac.uk/api/v2/identifiers/13470/?format=api"
    ],
    "projects": [
        "https://api.catalogue.ceda.ac.uk/api/v2/projects/37501/?format=api"
    ],
    "observationcollection_set": [],
    "responsiblepartyinfo_set": [
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/213884/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/213885/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/213886/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/213879/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/213880/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/213881/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/213882/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/213883/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/213887/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/213888/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/213889/?format=api"
    ],
    "procedureAcquisition": "https://api.catalogue.ceda.ac.uk/api/v2/acquisitions/44664/?format=api",
    "procedureCompositeProcess": null,
    "procedureComputation": null,
    "permissions": [
        {
            "ob_id": "https://api.catalogue.ceda.ac.uk/api/v2/observations/2532/?format=api",
            "useLimitation": null,
            "accessConstraints": null,
            "accessCategory": "restricted",
            "accessRoles": "ukmo_wx",
            "label": "restricted: ukmo_wx group",
            "licenceURL": "https://artefacts.ceda.ac.uk/licences/specific_licences/ukmo_agreement.pdf",
            "licenceClassifications": "academic"
        }
    ],
    "discoveryKeywords": []
}