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

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

{
    "ob_id": 43947,
    "uuid": "97791d46330b42838af744301c74a9fb",
    "title": "ESA Sea Ice Climate Change Initiative (Sea_Ice_cci): Drift-aware sea-ice thickness for the Northern Hemisphere from Envisat, v1.0",
    "abstract": "This dataset provides daily drift-aware sea ice freeboard and thickness maps, using satellite altimetry data from Envisat, covering the entire Arctic sea ice domain. Daily files are provided during boreal winter seasons (October to April).\r\n\r\nNeglecting sea ice drift when generating monthly sea ice thickness maps from satellite altimetry will cause blurring of the spatial distribution of ice thickness. This dataset synergizes sea ice freeboard and thickness information from satellite altimetry with sea ice drift estimates from passive microwave satellite sensors. Individual parcels of satellite altimeter measurements are advected daily over a time span of one month to obtain drift-aware sea ice freeboard and thickness maps. Because of the drift correction, this allows the determination of sea ice that was overflown by the satellite multiple times, and therefore the estimation of growth rates and changes in the sea ice thickness distribution due to deformation and thermodynamic ice growth between satellite overflights. With the estimation of sea ice growth, measurements can be corrected for the time offset between the acquisition day and the target day, the day to which all measurements within a month are projected.\r\n\r\nThese data have been produced as part of the European Space Agency (ESA)'s Climate Change Initiative (CCI) programme, as part of the ESA CCI Sea Ice project.",
    "keywords": "Sea Ice, ESA, CCI, Arctic, Drift Aware",
    "publicationState": "citable",
    "dataPublishedTime": "2025-05-21T14:15:19",
    "doiPublishedTime": "2025-05-21T14:28:37",
    "updateFrequency": "notPlanned",
    "status": "completed",
    "result_field": {
        "ob_id": "https://api.catalogue.ceda.ac.uk/api/v2/observations/44182/?format=api",
        "dataPath": "/neodc/esacci/sea_ice/data/drift_aware_sea_ice_thickness/L3C/envisat/v1.0/NH",
        "oldDataPath": [],
        "storageLocation": "internal",
        "storageStatus": "online",
        "volume": 6038255208,
        "numberOfFiles": 1213,
        "fileFormat": "NetCDF"
    },
    "timePeriod": "https://api.catalogue.ceda.ac.uk/api/v2/times/12371/?format=api",
    "geographicExtent": "https://api.catalogue.ceda.ac.uk/api/v2/bboxes/4783/?format=api",
    "nonGeographicFlag": false,
    "phenomena": [
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/63576/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/74945/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/74946/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/75280/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/75287/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/85586/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/85587/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/85588/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/85589/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/85590/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/85591/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/85592/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/85593/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/85594/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/85595/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/85596/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/85597/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/85598/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/85599/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/85600/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/85601/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/85602/?format=api"
    ],
    "dataLineage": "Data were processed by the ESA CCI Sea Ice project team and were supplied to CEDA in the context of the ESA CCI Open Data Portal. The following organisations were involved in the Sea_Ice_CCI project which resulted in production of this dataset: NORCE Norwegian Research Centre, Norwegian Meteorological Institute, Alfred Wegener Institute.",
    "removedDataTime": null,
    "removedDataReason": "",
    "language": "English",
    "identifier_set": [
        "https://api.catalogue.ceda.ac.uk/api/v2/identifiers/13392/?format=api"
    ],
    "projects": [
        "https://api.catalogue.ceda.ac.uk/api/v2/projects/14368/?format=api"
    ],
    "observationcollection_set": [
        "https://api.catalogue.ceda.ac.uk/api/v2/observationcollections/14367/?format=api"
    ],
    "responsiblepartyinfo_set": [
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/210045/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/210049/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/210050/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/210043/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/210044/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/210046/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/210047/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/210048/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/210051/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/211260/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/211261/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/211262/?format=api"
    ],
    "procedureAcquisition": null,
    "procedureCompositeProcess": null,
    "procedureComputation": "https://api.catalogue.ceda.ac.uk/api/v2/computations/44352/?format=api",
    "permissions": [
        {
            "ob_id": "https://api.catalogue.ceda.ac.uk/api/v2/observations/2573/?format=api",
            "useLimitation": null,
            "accessConstraints": null,
            "accessCategory": "public",
            "accessRoles": null,
            "label": "public: None group",
            "licenceURL": "https://artefacts.ceda.ac.uk/licences/specific_licences/esacci_seaice_terms_and_conditions.pdf",
            "licenceClassifications": "any"
        }
    ],
    "discoveryKeywords": [
        {
            "ob_id": 1140,
            "name": "ESACCI"
        }
    ]
}