Observation Instance – Django REST framework

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/43203/?format=api

HTTP 200 OK
Allow: GET, HEAD, OPTIONS
Content-Type: application/json
Vary: Accept

{
    "ob_id": 43203,
    "uuid": "debc301e309a45c68fe2e6f41329cd3b",
    "title": "EOCIS: Greenland Ice Sheet Surface Elevation Change, v1.0",
    "abstract": "This dataset contains Rates of Surface Elevation Change for the Greenland Ice Sheet produced within the Earth Observation Climate Information Service (EOCIS) project.\r\n\r\nSurface elevation change is provided as a 5x5 km grid over the land ice for the Greenland Ice Sheet (excluding peripheral ice caps and glaciers) and includes drainage basins (Mouginot et al 2019), delivered as NetCDF files.\r\n\r\nFor future updates to this dataset, see the EOCIS CPOM page in the related documents section.",
    "keywords": "Ice,Sheet,Surface,Elevation,Greenland,EOCIS",
    "publicationState": "citable",
    "dataPublishedTime": "2025-04-16T16:44:12",
    "doiPublishedTime": "2025-04-17T12:25:07",
    "updateFrequency": "notPlanned",
    "status": "completed",
    "result_field": {
        "ob_id": "https://api.catalogue.ceda.ac.uk/api/v2/observations/43859/?format=api",
        "dataPath": "/neodc/eocis/data/global_and_regional/land_ice/ice_sheet_surface_elevation_change/greenland",
        "oldDataPath": [],
        "storageLocation": "internal",
        "storageStatus": "online",
        "volume": 3247314182,
        "numberOfFiles": 328,
        "fileFormat": "NetCDF"
    },
    "timePeriod": "https://api.catalogue.ceda.ac.uk/api/v2/times/12335/?format=api",
    "geographicExtent": "https://api.catalogue.ceda.ac.uk/api/v2/bboxes/4640/?format=api",
    "nonGeographicFlag": false,
    "phenomena": [
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/18459/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/53130/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/53131/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/85674/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/85675/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/85676/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/85678/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/85679/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/85680/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/85682/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/85683/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/85684/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/86154/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/86155/?format=api"
    ],
    "dataLineage": "This dataset was produced by the Centre for Polar Observation and Modelling in the context of the Earth Observation Climate Information Service project.",
    "removedDataTime": null,
    "removedDataReason": "",
    "language": "English",
    "identifier_set": [
        "https://api.catalogue.ceda.ac.uk/api/v2/identifiers/13318/?format=api"
    ],
    "projects": [
        "https://api.catalogue.ceda.ac.uk/api/v2/projects/43216/?format=api"
    ],
    "observationcollection_set": [],
    "responsiblepartyinfo_set": [
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/209675/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/205500/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/205501/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/205502/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/206251/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/205497/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/205498/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/205499/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/206252/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/206253/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/206254/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/206255/?format=api"
    ],
    "procedureAcquisition": null,
    "procedureCompositeProcess": null,
    "procedureComputation": "https://api.catalogue.ceda.ac.uk/api/v2/computations/43247/?format=api",
    "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": []
}