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

{
    "ob_id": 27345,
    "uuid": "6312f1117b044e0288720f11a9fdd36d",
    "title": "Weighing trees with lasers: terrestrial laser scanner data; Malaysia Sabah Kabili-Sepilok Forest Reserve (Plot SEP-11), 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 Malaysia Sabah Kabili-Sepilok Forest Reserve on the 20th March 2017 . The plot site had the following geographical features; Moisture type: Moist, Elevation: Lowland, Edaphic Type: Terra Firme, Forrestry: Old-growth.\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-16T10:19:07",
    "doiPublishedTime": null,
    "updateFrequency": "",
    "status": "completed",
    "result_field": {
        "ob_id": "https://api.catalogue.ceda.ac.uk/api/v2/observations/27343/?format=api",
        "dataPath": "/neodc/tls/data/raw/malaysia/SEP-11/2017-03-20.001.riproject/",
        "oldDataPath": [],
        "storageLocation": "internal",
        "storageStatus": "online",
        "volume": 61384847996,
        "numberOfFiles": 2243,
        "fileFormat": "Scan folder contain a number of file formats \r\n\r\n.pat RIEGAL terrestrial lase scan file containing information on laser scan pattern (see documentation for software)\r\n\r\n.png Potable Network graphics format in wide use see specification \r\n\r\n.rxp RXP file in proprietary format use by RIEGL makes of the laser scanners  (see software links in documentation )\r\n\r\n.prv Contains preview image of 3D scene. Image preview created by proprietary software program used for 3D environment modeling; contains a preview image of a 3D scene, which typically has a lower resolution than the final rendered scene; used for storing scene previews before final production (see software information in documentation). \r\n\r\n.rfl ASCII “Roll Forward Log file” from containing log information from RIEGL instrument \r\n\r\n.csv CSV file containing metadata generated by RIEDL laser scanner see  documentation\r\n\r\nASCII formatted text files containing RIEGL laser scanner information"
    },
    "timePeriod": "https://api.catalogue.ceda.ac.uk/api/v2/times/12474/?format=api",
    "geographicExtent": "https://api.catalogue.ceda.ac.uk/api/v2/bboxes/2378/?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/114354/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/114357/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/114350/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/114346/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/114351/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/114352/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/114358/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/114355/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/114356/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/114347/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/114353/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/114439/?format=api"
    ],
    "procedureAcquisition": "https://api.catalogue.ceda.ac.uk/api/v2/acquisitions/27344/?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"
        }
    ]
}