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

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

{
    "ob_id": 43756,
    "uuid": "28b0d1ced8f944d593446d45d02d8894",
    "title": "NAMBLEX: SNR winds from the NCAS Mobile Radar Wind Profiler unit 1 deployed at the Mace Head Atmospheric Research Facility, Ireland, v8.0 (20020801-20020831)",
    "abstract": "Vertical profiles of signal to noise ratio (SNR) and winds measurements from the NCAS Mobile Radar Wind Profiler unit 1 deployed at the Mace Head Atmospheric Research Facility, Ireland. These observations were taken as part of North Atlantic Marine Boundary Layer EXperiment (NAMBLEX) between 20020801 and 20020831.\r\n\r\nData products from this deployment include: snr-winds\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-04-28T12:23:02",
    "doiPublishedTime": "2025-04-28T12:23:04.306968",
    "updateFrequency": "notPlanned",
    "status": "completed",
    "result_field": {
        "ob_id": "https://api.catalogue.ceda.ac.uk/api/v2/observations/43757/?format=api",
        "dataPath": "/badc/ncas-mobile/data/ncas-radar-wind-profiler-1/20020801_namblex/v8.0",
        "oldDataPath": [],
        "storageLocation": "internal",
        "storageStatus": "online",
        "volume": 34647897,
        "numberOfFiles": 52,
        "fileFormat": "Data are netCDF formatted."
    },
    "timePeriod": "https://api.catalogue.ceda.ac.uk/api/v2/times/12222/?format=api",
    "geographicExtent": "https://api.catalogue.ceda.ac.uk/api/v2/bboxes/4553/?format=api",
    "nonGeographicFlag": false,
    "phenomena": [
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/50510/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/50512/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/50542/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/50543/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/52201/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/52205/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/52206/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/52212/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/63667/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/75838/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/75839/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/75840/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/75841/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/75842/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/75843/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/75844/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/75845/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/75846/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/75847/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/75848/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/75849/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/75850/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/75851/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/75852/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/75853/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/75854/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/75855/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/75856/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/75857/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/75858/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/75859/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/75860/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/75861/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/75862/?format=api"
    ],
    "dataLineage": "Data were processed and prepared by the NCAS instrument scientist following the NCAS data standards 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/13350/?format=api"
    ],
    "projects": [
        "https://api.catalogue.ceda.ac.uk/api/v2/projects/7595/?format=api"
    ],
    "observationcollection_set": [
        "https://api.catalogue.ceda.ac.uk/api/v2/observationcollections/7592/?format=api"
    ],
    "responsiblepartyinfo_set": [
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/209334/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/209335/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/209336/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/209337/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/209338/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/209339/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/209340/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/209341/?format=api"
    ],
    "procedureAcquisition": "https://api.catalogue.ceda.ac.uk/api/v2/acquisitions/43758/?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": []
}