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

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

{
    "ob_id": 43432,
    "uuid": "8234e536542141259e0ec632d45df496",
    "title": "Sea Surface Skin Temperature from SISTeR: QM2 Cruise 28, v2.5",
    "abstract": "Sea Surface Skin Temperature data from the SISTeR instrument (Scanning Infrared Sea surface Temperature Radiometer). This dataset contains SST data of the north Atlantic and the North Sea measured by SISTeR on-board RMS Queen Mary 2 (QM2) between 16 May 2024 and 30 August 2024.\r\n\r\nThese data may be used freely, however we request they are not used as inputs to assimilated SST products, as the primary purpose of these data is for validation of such products.",
    "keywords": "SLSTR,Validation,RMS Queen Mary 2,SST",
    "publicationState": "citable",
    "dataPublishedTime": "2026-01-26T17:07:07",
    "doiPublishedTime": "2026-02-19T09:06:15.782990",
    "updateFrequency": "notPlanned",
    "status": "completed",
    "result_field": {
        "ob_id": "https://api.catalogue.ceda.ac.uk/api/v2/observations/44501/?format=api",
        "dataPath": "/neodc/ral_ship_sst/data/QM2/Cruise28/fv2.5/",
        "oldDataPath": [],
        "storageLocation": "internal",
        "storageStatus": "online",
        "volume": 775278867,
        "numberOfFiles": 202,
        "fileFormat": "NetCDF"
    },
    "timePeriod": "https://api.catalogue.ceda.ac.uk/api/v2/times/12125/?format=api",
    "geographicExtent": "https://api.catalogue.ceda.ac.uk/api/v2/bboxes/4971/?format=api",
    "nonGeographicFlag": false,
    "phenomena": [
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/50559/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/50561/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/52652/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/52654/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/52655/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/52656/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/80293/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/80294/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/80295/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/80296/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/80297/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/80298/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/80299/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/80300/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/80301/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/80302/?format=api"
    ],
    "dataLineage": "Measurements taken on the QM2 and processed with SISTeR processor version 2.5.1 to levels 2R and 3R as specified by the GHRSST recommended format.\r\n\r\nShip time and services were provided by Cunard Line.",
    "removedDataTime": null,
    "removedDataReason": "",
    "language": "English",
    "identifier_set": [
        "https://api.catalogue.ceda.ac.uk/api/v2/identifiers/13730/?format=api"
    ],
    "projects": [
        "https://api.catalogue.ceda.ac.uk/api/v2/projects/44841/?format=api"
    ],
    "observationcollection_set": [
        "https://api.catalogue.ceda.ac.uk/api/v2/observationcollections/44842/?format=api"
    ],
    "responsiblepartyinfo_set": [
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/216466/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/206746/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/206747/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/206748/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/206749/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/206750/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/206751/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/206745/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/206752/?format=api"
    ],
    "procedureAcquisition": "https://api.catalogue.ceda.ac.uk/api/v2/acquisitions/44504/?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": []
}