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

{
    "ob_id": 44551,
    "uuid": "03634cd8f10943b39d9982e6f9bbb402",
    "title": "Weighing trees with lasers: terrestrial laser scanner data; Danum Valley Conservation Area (Plot CBN-01), March 2017",
    "abstract": "This dataset is comprised of raw and proceesed  data from the NERC-funded, full waveform terrestrial laser scanner (TLS) deployed on a  plot site  situated in the Danum Valley Conservation Area. Danum Valley Conservation Area is a 438 square kilometres (169 sq mi) tract of relatively undisturbed lowland dipterocarp forest in Sabah, Malaysia. It has an extensive diversity of tropical flora and fauna.\r\n\r\nThere were no human settlements within the area before it became a conservation area, meaning that hunting, logging and other human interference were non-existent, making the area almost unique. It is managed by Yayasan Sabah for conservation, research, education, and habitat restoration training purposes. \r\n\r\nThe aim of the weighing trees with lasers project is to test if current allometric relationships are invariant across continents, or whether they differ significantly, and require continental level models; quantify the impact of assumptions of tree shape and wood density on tropical forest allometry; test hypotheses relating to pan-tropical differences in observed AGB (Above Ground Biomass) from satellite and field data. It also aims to apply new knowledge to assessing retrieval accuracy of forthcoming ESA BIOMASS and NASA GEDI (Global Ecosystem Dynamics Investigation Lidar) missions and providing calibration datasets; In addition to testing the capability of low-cost instruments to augment TLS data including: UAVs (unmanned aerial vehicle) for mapping cover and canopy height; low-cost lidar instruments to assess biomass rapidly, at lower accuracy.",
    "keywords": "Terrestrial Laser Scanner data, Malaysia Sabah Kabili-Sepilok Forest Reserve, Moist, Lowland, Terra Firme, Old-growth",
    "publicationState": "published",
    "dataPublishedTime": "2025-06-25T14:36:25",
    "doiPublishedTime": null,
    "updateFrequency": "",
    "status": "completed",
    "result_field": {
        "ob_id": "https://api.catalogue.ceda.ac.uk/api/v2/observations/44552/?format=api",
        "dataPath": "/neodc/tls/data/raw/malaysia/CBN-01/2017-03-28.001.riproject",
        "oldDataPath": [],
        "storageLocation": "internal",
        "storageStatus": "online",
        "volume": 58505219712,
        "numberOfFiles": 2449,
        "fileFormat": "The scan folder contains a number of open and proprietary formats file formats CSV, ASCII, text, PNG , RXP and PAT"
    },
    "timePeriod": "https://api.catalogue.ceda.ac.uk/api/v2/times/12488/?format=api",
    "geographicExtent": "https://api.catalogue.ceda.ac.uk/api/v2/bboxes/4801/?format=api",
    "nonGeographicFlag": false,
    "phenomena": [],
    "dataLineage": "Provided by Andrew Burt UCL to  CEDA for publication",
    "removedDataTime": null,
    "removedDataReason": "",
    "language": "English",
    "identifier_set": [],
    "projects": [
        "https://api.catalogue.ceda.ac.uk/api/v2/projects/26683/?format=api"
    ],
    "observationcollection_set": [
        "https://api.catalogue.ceda.ac.uk/api/v2/observationcollections/30128/?format=api"
    ],
    "responsiblepartyinfo_set": [
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/213198/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/213199/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/213201/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/213197/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/213202/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/213206/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/213203/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/213204/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/213205/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/213208/?format=api"
    ],
    "procedureAcquisition": "https://api.catalogue.ceda.ac.uk/api/v2/acquisitions/44553/?format=api",
    "procedureCompositeProcess": null,
    "procedureComputation": null,
    "permissions": [
        {
            "ob_id": "https://api.catalogue.ceda.ac.uk/api/v2/observations/2528/?format=api",
            "useLimitation": null,
            "accessConstraints": null,
            "accessCategory": "public",
            "accessRoles": null,
            "label": "public: None group",
            "licenceURL": "http://creativecommons.org/licenses/by/4.0/",
            "licenceClassifications": "any"
        }
    ],
    "discoveryKeywords": [
        {
            "ob_id": 1138,
            "name": "NDGO0003"
        }
    ]
}