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/43640/?format=api
HTTP 200 OK
Allow: GET, HEAD, OPTIONS
Content-Type: application/json
Vary: Accept

{
    "ob_id": 43640,
    "uuid": "691e8c36bb9446efaa46cc67d37aadae",
    "title": "Met Office Cardington: cloud height measurements from a Vaisala CT25K_B Laser Ceilometer, 2015-2024",
    "abstract": "The Met Office Observation-based research Boundary Layer Facility, at the semi-rural field site (18 Ha) of Cardington (52° 06′ N, 00° 25′ W, 29 m ± 1 m amsl) in central-southern England between 2004 and 2024, operated two Vaisala CT25K ceilometers deployed at Cardington since 2014, denoted by unit numbers A and B. This dataset covers data from unit B.\r\n\r\nThe CT25K Laser ceilometer is a general-purpose cloud height sensor employing LIDAR technology for detection of clouds, precipitation and other obstructions to vision. The CT25K provides reliable determination of cloud height up to 25,000 feet (7.5 km) thus covering most heights where dense clouds appear. It is designed to detect up to three possible cloud layers.\r\n\r\nThe Vaisala CT25K laser ceilometer measures cloud height-or vertical visibility if the cloud base is obscured. The single-lens design also ensures reliable measurements in fog, rain, snow and haze.\r\n\r\nA full list of NetCDF variables can be found in \"Continuous meteorological surface and soil records (2004-2024) at the Met Office surface site of Cardington, UK.\" Osborne et al. ESSD (2025). This paper should be referenced in any research/publications pertaining to this dataset.\r\n\r\nTo ensure optimal traceability and transparency of data, comprehensive metadata is included.",
    "keywords": "ceilometer, cloud height, cloud base, measurement, Cardington, Met Office",
    "publicationState": "citable",
    "dataPublishedTime": "2025-04-28T12:59:54",
    "doiPublishedTime": "2025-04-28T12:59:54",
    "updateFrequency": "notPlanned",
    "status": "completed",
    "result_field": {
        "ob_id": "https://api.catalogue.ceda.ac.uk/api/v2/observations/44161/?format=api",
        "dataPath": "/badc/ukmo-cardington/data/complete-collection/ceilometer/ct25k-B/",
        "oldDataPath": [],
        "storageLocation": "internal",
        "storageStatus": "online",
        "volume": 10363193204,
        "numberOfFiles": 3317,
        "fileFormat": "Data are NetCDF formatted"
    },
    "timePeriod": "https://api.catalogue.ceda.ac.uk/api/v2/times/12367/?format=api",
    "geographicExtent": "https://api.catalogue.ceda.ac.uk/api/v2/bboxes/39/?format=api",
    "nonGeographicFlag": false,
    "phenomena": [
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/75733/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/75863/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/75864/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/75865/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/75866/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/75867/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/75868/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/75869/?format=api"
    ],
    "dataLineage": "Data were collected by the Met Office Meteorological Research Unit, Cardington, during its operational period. These data have been standardised for the production of this dataset, following similar file metadata conventions for all associated datasets within the continuous hydro-meteorological record (2004-2024) at the Met Office surface site of Cardington, UK Dataset Collection, as described more fully within Osborne et al., (2025). This standardisation approach addressed, where possible, any known data and metadata issues. Data were then deposited at the 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/13360/?format=api"
    ],
    "projects": [
        "https://api.catalogue.ceda.ac.uk/api/v2/projects/20010/?format=api"
    ],
    "observationcollection_set": [
        "https://api.catalogue.ceda.ac.uk/api/v2/observationcollections/43597/?format=api"
    ],
    "responsiblepartyinfo_set": [
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/208847/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/208846/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/208848/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/208849/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/208850/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/208851/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/208852/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/208853/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/208854/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/208855/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/208856/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/208857/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/208858/?format=api"
    ],
    "procedureAcquisition": "https://api.catalogue.ceda.ac.uk/api/v2/acquisitions/44217/?format=api",
    "procedureCompositeProcess": null,
    "procedureComputation": null,
    "permissions": [
        {
            "ob_id": "https://api.catalogue.ceda.ac.uk/api/v2/observations/2526/?format=api",
            "useLimitation": null,
            "accessConstraints": null,
            "accessCategory": "public",
            "accessRoles": null,
            "label": "public: None group",
            "licenceURL": "http://www.nationalarchives.gov.uk/doc/open-government-licence/version/3/",
            "licenceClassifications": "any"
        }
    ],
    "discoveryKeywords": []
}