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

{
    "ob_id": 44921,
    "uuid": "b687c4d9dd374aafb3034efe005c0ee5",
    "title": "GLAMOUR: Global building morphology dataset for urban climate modelling (2020)",
    "abstract": "The GLobAl building MOrphology dataset for URban hydroclimate modelling (GLAMOUR) is derived from open-source Sentinel imagery that captures the average building height and footprint at a resolution of 0.0009° across urbanized areas worldwide (approximately 100 m at the equator) across 13189 urban areas globally from 01/01/2020 to 31/12/2020. This dataset optimally leverages multi-task DL (MTDL) models, publicly accessible satellite images in conjunction with the Google Cloud ecosystem to enable efficient and accurate large-scale mapping. This building morphology dataset provides an unprecedented possibility for enabling various urban hydroclimate applications at a global scale, including human thermal comfort simulation, building energy modelling, 3D flood risk analysis among others. \r\n\r\nData are netCDF formatted and contain the following variables:\r\n  - BH: building height (m)\r\n  - BF: building footprint (m2 m-2)\r\n\r\nEach file is named following the convention: `GLAMOUR_{lon_start}_{lon_end}_{lat_start}_{lat_end}.nc`, where:\r\n  - {lon_start} and {lon_end} are the longitude coordinates of the lower-left and upper-right corners of the grid, respectively.\r\n  - {lat_start} and {lat_end} are the latitude coordinates of the lower-left and upper-right corners of the grid, respectively.",
    "keywords": "GLAMOUR,Building morphology,Hydroclimate modelling",
    "publicationState": "published",
    "dataPublishedTime": "2025-11-06T14:35:20",
    "doiPublishedTime": null,
    "updateFrequency": "notPlanned",
    "status": "pending",
    "result_field": {
        "ob_id": "https://api.catalogue.ceda.ac.uk/api/v2/observations/44924/?format=api",
        "dataPath": "/badc/deposited2025/GLAMOUR",
        "oldDataPath": [],
        "storageLocation": "internal",
        "storageStatus": "online",
        "volume": 1255955369,
        "numberOfFiles": 261,
        "fileFormat": "NetCDF"
    },
    "timePeriod": "https://api.catalogue.ceda.ac.uk/api/v2/times/12736/?format=api",
    "geographicExtent": "https://api.catalogue.ceda.ac.uk/api/v2/bboxes/4891/?format=api",
    "nonGeographicFlag": false,
    "phenomena": [
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/32072/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/57405/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/57406/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/63367/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/92546/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/92547/?format=api"
    ],
    "dataLineage": "GLAMOUR is produced using a multi-task deep learning model SHAFTS based on Sentinel-1 and Sentinel-2 satellite images. The SHAFTS model is trained on a large-scale dataset of building footprints and heights from OpenStreetMap and Google Earth Engine. The SHAFTS model is then used to predict building footprints and heights for urban areas identified based population density outlined by the Gridded Population of the World, Version 4 (GPWv4) dataset and the Global Human Settlement-Urban Centre Database (GHS-UCDB).",
    "removedDataTime": null,
    "removedDataReason": "",
    "language": "English",
    "identifier_set": [],
    "projects": [
        "https://api.catalogue.ceda.ac.uk/api/v2/projects/44922/?format=api"
    ],
    "observationcollection_set": [],
    "responsiblepartyinfo_set": [
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/215250/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/215239/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/215240/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/215241/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/215242/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/215243/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/215238/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/215245/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/215244/?format=api"
    ],
    "procedureAcquisition": null,
    "procedureCompositeProcess": null,
    "procedureComputation": "https://api.catalogue.ceda.ac.uk/api/v2/computations/44923/?format=api",
    "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": []
}