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

{
    "ob_id": 44545,
    "uuid": "8953a6e5320f4f0e9cba0b51538c1544",
    "title": "Weighing trees with lasers project: terrestrial laser scanner data; Armstong Redwoods State Natural Reserve (Plot CALI-04), September 2017",
    "abstract": "This dataset is comprised of raw data from the NERC-funded, full waveform terrestrial laser scanner (TLS) deployed at sites on three continents, multiple countries and plot locations, which have been re-surveyed at different times. \r\n\r\nArmstrong Redwoods State Natural Reserve is a state park of California in the United States established to preserve 805 acres (326 ha) of coast redwoods (Sequoia sempervirens). The reserve is located in Sonoma County, just north of Guerneville. The reserve is in a temperate rainforest. The climate is mild and wet. The park receives an average of 55 inches (1.4 m) of rainfall per year, almost all between September and June. Abundant fog during the summer months helps to maintain the moist conditions required by the coast redwoods. \r\n\r\nThe project scanned all trees in the permanent sample plot (PSP) spanning a range of soil fertility and productivity gradients (24 x 1 ha PSPs in total).  The 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,  Armstong Redwoods State Natural Reserve, old growth redwoods, coastal redwoods",
    "publicationState": "published",
    "dataPublishedTime": "2025-06-25T13:11:57",
    "doiPublishedTime": null,
    "updateFrequency": "",
    "status": "completed",
    "result_field": {
        "ob_id": "https://api.catalogue.ceda.ac.uk/api/v2/observations/44546/?format=api",
        "dataPath": "/neodc/tls/data/raw/usa/CALI-04/2017-09-12.001.riproject",
        "oldDataPath": [],
        "storageLocation": "internal",
        "storageStatus": "online",
        "volume": 13598786998,
        "numberOfFiles": 465,
        "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/12486/?format=api",
    "geographicExtent": "https://api.catalogue.ceda.ac.uk/api/v2/bboxes/4800/?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/26677/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/observationcollections/30128/?format=api"
    ],
    "responsiblepartyinfo_set": [
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/213158/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/213159/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/213160/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/213161/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/213162/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/213163/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/213164/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/213165/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/213166/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/213167/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/213168/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/213169/?format=api"
    ],
    "procedureAcquisition": "https://api.catalogue.ceda.ac.uk/api/v2/acquisitions/44542/?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"
        }
    ]
}