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

{
    "ob_id": 43641,
    "uuid": "06a71fd559884416ad798e452aa21bef",
    "title": "Met Office Cardington: cloud height measurements from a Impulsphysik LD25 Laser Ceilometer, 2003-2014",
    "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 the Impulsphysik LD25 Ceilometer between 2003-2014.\r\n\r\nThe LD25 Laser Ceilometer is a general-purpose cloud height sensor employing LIDAR technology for detection of clouds, precipitation and other obstructions to vision. The LD25 operates according to the Light Detection and Ranging (LIDAR) principle. It transmits short pulses of laser light which are scattered back to the instrument from atmospheric targets. The distance of the targets from the instrument is determined by the time delay between the transmission and reception of a pulse. The instrument is vertically-pointing (zenith angle=0) and so the distance gives a measure of the altitude of the targets above ground-level.  \r\n\r\nThe LD25 provides reliable determination of cloud height up to 7.5 km. It is designed to detect up to three possible cloud layers.\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-05-12T15:30:30",
    "doiPublishedTime": "2025-06-25T12:00:33",
    "updateFrequency": "notPlanned",
    "status": "final",
    "result_field": {
        "ob_id": "https://api.catalogue.ceda.ac.uk/api/v2/observations/44253/?format=api",
        "dataPath": "/badc/ukmo-cardington/data/complete-collection/ceilometer/ld25",
        "oldDataPath": [],
        "storageLocation": "internal",
        "storageStatus": "online",
        "volume": 75069270666,
        "numberOfFiles": 3167,
        "fileFormat": "Data are NetCDF formatted"
    },
    "timePeriod": "https://api.catalogue.ceda.ac.uk/api/v2/times/12154/?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/75866/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/75960/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/75961/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/75962/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/75963/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/75964/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/75965/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/75966/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/75967/?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/13431/?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/208859/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/208860/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/208861/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/208862/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/208863/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/208864/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/208865/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/208866/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/208867/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/208868/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/208869/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/208870/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/208871/?format=api"
    ],
    "procedureAcquisition": "https://api.catalogue.ceda.ac.uk/api/v2/acquisitions/44257/?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": []
}