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

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

{
    "ob_id": 44513,
    "uuid": "3080771112d947e8bcfd7d130f753c01",
    "title": "WOEST: aerosol backscatter from the NCAS Aerosol Lidar unit 1 deployed at MOD Lyneham, v1.0 (20230530-20230911)",
    "abstract": "Aerosol backscatter measurements from the NCAS Aerosol Lidar unit 1 deployed at MOD Lyneham. These observations were taken as part of Wessex convection experiment - Observing the Evolving Structures of Turbulence (WOEST) between 20230530 and 20230911.\r\n\r\nData products from this deployment version 1.0 include: range_squared_corrected_backscatter_power \r\n\r\nFor further details of this deployment and the associated dataset please see the internal file metadata.\r\n\r\nThese data conform to the NCAS data standards and are available under the UK Government Open Licence agreement. Acknowledgement of NCAS as the data provider is required whenever and wherever these data are used.",
    "keywords": "NCAS, observation measurements",
    "publicationState": "citable",
    "dataPublishedTime": "2025-08-01T09:59:15",
    "doiPublishedTime": "2025-08-01T09:59:00.213444",
    "updateFrequency": "notPlanned",
    "status": "completed",
    "result_field": {
        "ob_id": "https://api.catalogue.ceda.ac.uk/api/v2/observations/44514/?format=api",
        "dataPath": "/badc/ncas-mobile/data/ncas-lidar-aerosol-1/20230531_woest/v1.0/",
        "oldDataPath": [],
        "storageLocation": "internal",
        "storageStatus": "online",
        "volume": 2764988302,
        "numberOfFiles": 310,
        "fileFormat": "Data are netCDF formatted."
    },
    "timePeriod": "https://api.catalogue.ceda.ac.uk/api/v2/times/12481/?format=api",
    "geographicExtent": "https://api.catalogue.ceda.ac.uk/api/v2/bboxes/4798/?format=api",
    "nonGeographicFlag": false,
    "phenomena": [
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/53939/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/53940/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/58081/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/65555/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/74110/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/75915/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/75916/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/75917/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/75918/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/75922/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/75924/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/84196/?format=api"
    ],
    "dataLineage": "Data were processed and prepared by the project team before delivery to the Centre for Environmental Data Analysis (CEDA).",
    "removedDataTime": null,
    "removedDataReason": "",
    "language": "English",
    "identifier_set": [
        "https://api.catalogue.ceda.ac.uk/api/v2/identifiers/13459/?format=api"
    ],
    "projects": [
        "https://api.catalogue.ceda.ac.uk/api/v2/projects/43720/?format=api"
    ],
    "observationcollection_set": [
        "https://api.catalogue.ceda.ac.uk/api/v2/observationcollections/43875/?format=api"
    ],
    "responsiblepartyinfo_set": [
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/213044/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/213045/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/213046/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/213047/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/213048/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/213049/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/213051/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/213050/?format=api"
    ],
    "procedureAcquisition": "https://api.catalogue.ceda.ac.uk/api/v2/acquisitions/44515/?format=api",
    "procedureCompositeProcess": null,
    "procedureComputation": null,
    "permissions": [
        {
            "ob_id": "https://api.catalogue.ceda.ac.uk/api/v2/observations/2522/?format=api",
            "useLimitation": null,
            "accessConstraints": null,
            "accessCategory": "registered",
            "accessRoles": null,
            "label": "registered: None group",
            "licenceURL": "http://www.nationalarchives.gov.uk/doc/open-government-licence/version/3/",
            "licenceClassifications": "any"
        }
    ],
    "discoveryKeywords": []
}