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

{
    "ob_id": 27346,
    "uuid": "275dd9bd0a9f42ff8b226c542b16a772",
    "title": "Weighing trees with lasers project: terrestrial laser scanner data; Peru Madre De Dios Tambopata National Reserve (Plot TAM-05),  May 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. This plot site was situated in Peru Madre De Dios Tambopata National Reserve. The plot site had the following geographical features; Moisture type: Moist, Elevation: Lowland, Edaphic Type: Terra Firme, Composition Mixed Forrest , Substrate Geology: Pre-Holocence, Forrestry: Old-growth.\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, data; Peru Madre De Dios Tambopata National Reserve , Moisture type: Moist, Elevation: Lowland, Edaphic Type: Terra Firme, Composition Mixed Forrest , Substrate Geology: Pre-Holocence, Forrestry: Old-growth",
    "publicationState": "published",
    "dataPublishedTime": "2025-06-16T10:37:24",
    "doiPublishedTime": null,
    "updateFrequency": "",
    "status": "completed",
    "result_field": {
        "ob_id": "https://api.catalogue.ceda.ac.uk/api/v2/observations/27347/?format=api",
        "dataPath": "/neodc/tls/data/raw/peru/TAM-05/2017-05-08.001.riproject/",
        "oldDataPath": [],
        "storageLocation": "internal",
        "storageStatus": "online",
        "volume": 57084831882,
        "numberOfFiles": 2599,
        "fileFormat": "Scan folder contain a number of file formats CSV, ASCII, text, PNG , RXP and PAT"
    },
    "timePeriod": "https://api.catalogue.ceda.ac.uk/api/v2/times/12475/?format=api",
    "geographicExtent": "https://api.catalogue.ceda.ac.uk/api/v2/bboxes/2379/?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/30127/?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/114363/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/114370/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/114369/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/114359/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/114365/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/114367/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/114366/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/114368/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/114371/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/114360/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/114364/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/114361/?format=api"
    ],
    "procedureAcquisition": "https://api.catalogue.ceda.ac.uk/api/v2/acquisitions/27348/?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"
        }
    ]
}