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

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

{
    "ob_id": 44660,
    "uuid": "c8038337158c4ecd90d21c0a199cce41",
    "title": "WesCon: precipitation measurements from the Met Office Thies disdrometer at Airfield Camp, Netheravon, v1.0 (20230419-20230919)",
    "abstract": "Precipitation measurements from the Met Office Thies disdrometer 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 Thies laser disdrometer is a laser optical device used for the measurement of diameter and fall velocity of hydrometeors. From such measurements, it is possible to classify different types of precipitation, such as drizzle, rain, hail, snow, and mixed precipitation, quantify precipitation in a time interval, and derive size and velocity joint distribution. Thies laser disdrometer can in addition detect fine drizzle, drop fall speed and drop size distribution. \r\nTo ensure optimal traceability and transparency of data, comprehensive metadata is included.",
    "keywords": "WesCon, Met Office, precipitation, rainfall, drizzle rate, droplet size distribution, fall speed, spectra",
    "publicationState": "citable",
    "dataPublishedTime": "2025-08-07T08:14:50",
    "doiPublishedTime": "2025-08-07T09:48:27",
    "updateFrequency": "notPlanned",
    "status": "completed",
    "result_field": {
        "ob_id": "https://api.catalogue.ceda.ac.uk/api/v2/observations/44662/?format=api",
        "dataPath": "/badc/woest/data/metoffice-disdrometer/",
        "oldDataPath": [],
        "storageLocation": "internal",
        "storageStatus": "online",
        "volume": 398590300,
        "numberOfFiles": 147,
        "fileFormat": "NetCDF"
    },
    "timePeriod": "https://api.catalogue.ceda.ac.uk/api/v2/times/12562/?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/75740/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/75741/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/75746/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/75749/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/75750/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/75751/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/75753/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/75754/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/75755/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/75759/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/75760/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/75761/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/75762/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/84629/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/84630/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/84631/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/84632/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/84633/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/84634/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/84635/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/84636/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/84637/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/84638/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/84639/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/84640/?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/13471/?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/213873/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/213872/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/213874/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/213867/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/213868/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/213869/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/213870/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/213871/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/213875/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/213876/?format=api"
    ],
    "procedureAcquisition": "https://api.catalogue.ceda.ac.uk/api/v2/acquisitions/44661/?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": []
}