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

{
    "ob_id": 43617,
    "uuid": "77bef4103ec2426281a5e74ccc0ba5c7",
    "title": "Met Office Cardington: vertical wind profiles and backscatter measurements from Halo Doppler Lidar unit 35, 2012-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 three Halo Photonics Streamline Doppler lidars, denoted by unit numbers 01, 30 and 35. This dataset covers data from unit 35.\r\n\r\nAll three Halo systems were 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 systems are capable of full hemispheric scanning of the backscatter coefficient and radial velocity as a function of beam range.\r\n\r\nThe usual operation at Cardington was vertical stares (zenith angle=0°) with periodic wind scans that invoked various options of off-axis views. Wind profiles performed every 30 min was the default operation for wind scans. Most profiles of horizontal wind within the dataset are based on DBS (Doppler beam swinging) scans which use a tri-axis azimuthally orthogonal technique using the single lidar beam to retrieve horizontal mean wind components. This scan was chosen for the bulk of the time because it only takes about 21 s to complete, which leaves 98% of the available time to vertical stares if one wind scan is completed every 30 min. More recent scans in the dataset have used multi-axis VAD (velocity azimuth display) scans, which are a more involved version of the DBS scans and use 6 or 12 point off-zenith views. The vertical stares, DBS and VAD wind scans produced separate archived netCDF files.\r\n\r\nAlthough depolarisation capability was possible with #35, this was only switched on occasionally during certain weather conditions.\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": "Doppler lidar, vertical stares, wind scans, measurement, Cardington, Met Office",
    "publicationState": "citable",
    "dataPublishedTime": "2025-04-26T08:12:15",
    "doiPublishedTime": "2025-04-28T08:24:40",
    "updateFrequency": "notPlanned",
    "status": "completed",
    "result_field": {
        "ob_id": "https://api.catalogue.ceda.ac.uk/api/v2/observations/43707/?format=api",
        "dataPath": "/badc/ukmo-cardington/data/complete-collection/lidar/halo-lidar-35",
        "oldDataPath": [],
        "storageLocation": "internal",
        "storageStatus": "online",
        "volume": 856666272579,
        "numberOfFiles": 7165,
        "fileFormat": "Data are NetCDF formatted"
    },
    "timePeriod": "https://api.catalogue.ceda.ac.uk/api/v2/times/12151/?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/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 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/13325/?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/208500/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/208494/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/208495/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/208496/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/208497/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/208498/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/208499/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/208493/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/208501/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/208502/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/208503/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/208504/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/208505/?format=api"
    ],
    "procedureAcquisition": "https://api.catalogue.ceda.ac.uk/api/v2/acquisitions/43680/?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": []
}