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

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

{
    "ob_id": 45948,
    "uuid": "16d77f6aa75c46b8b1e60f713a4aca78",
    "title": "Sea ice and melt pond fraction from video analysis for the Arctic Summertime Cyclones Project",
    "abstract": "Data from analysis of six MASIN flights from the Arctic Summertime Cyclones field campaign in Summer 2022. Each data point corresponds to a flux-run of a duration of ~1 minute.  Bulk variables are averaged (mean) along each flux-run, unless otherwise stated in variable description. The sea-ice fraction and melt-pond fraction are from subjectively analysed video footage, where the fraction of sea ice and melt ponds are recorded every minute. Fractions are recorded to the nearest 5% and benchmarked by objective image color analysis of still images. The data set was compiled by Miriam Bennett, with help from Ian Renfrew and Chris Barrell (all University of East Anglia).",
    "keywords": "MASIN, sea ice, melt pond, NE/T006773/1",
    "publicationState": "published",
    "dataPublishedTime": "2026-05-20T09:41:20",
    "doiPublishedTime": null,
    "updateFrequency": "notPlanned",
    "status": "completed",
    "result_field": {
        "ob_id": "https://catalogue.ceda.ac.uk/api/v2/observations/45949/?format=api",
        "dataPath": "/badc/arcticcyclones/data/ASC_sea_ice_and_melt_pond_fraction",
        "oldDataPath": [],
        "storageLocation": "internal",
        "storageStatus": "online",
        "volume": 82132,
        "numberOfFiles": 3,
        "fileFormat": "ASCII text"
    },
    "timePeriod": "https://catalogue.ceda.ac.uk/api/v2/times/13191/?format=api",
    "geographicExtent": "https://catalogue.ceda.ac.uk/api/v2/bboxes/5153/?format=api",
    "nonGeographicFlag": false,
    "phenomena": [
        "https://catalogue.ceda.ac.uk/api/v2/phenomona/4385/?format=api",
        "https://catalogue.ceda.ac.uk/api/v2/phenomona/18405/?format=api",
        "https://catalogue.ceda.ac.uk/api/v2/phenomona/18408/?format=api",
        "https://catalogue.ceda.ac.uk/api/v2/phenomona/50340/?format=api",
        "https://catalogue.ceda.ac.uk/api/v2/phenomona/92544/?format=api",
        "https://catalogue.ceda.ac.uk/api/v2/phenomona/93410/?format=api",
        "https://catalogue.ceda.ac.uk/api/v2/phenomona/93411/?format=api",
        "https://catalogue.ceda.ac.uk/api/v2/phenomona/93412/?format=api",
        "https://catalogue.ceda.ac.uk/api/v2/phenomona/93413/?format=api",
        "https://catalogue.ceda.ac.uk/api/v2/phenomona/93414/?format=api",
        "https://catalogue.ceda.ac.uk/api/v2/phenomona/93415/?format=api",
        "https://catalogue.ceda.ac.uk/api/v2/phenomona/93416/?format=api"
    ],
    "dataLineage": "These data were produced by the project team and the output data were then supplied to CEDA for archiving.",
    "removedDataTime": null,
    "removedDataReason": "",
    "language": "English",
    "identifier_set": [],
    "projects": [
        "https://catalogue.ceda.ac.uk/api/v2/projects/41265/?format=api"
    ],
    "observationcollection_set": [],
    "responsiblepartyinfo_set": [
        "https://catalogue.ceda.ac.uk/api/v2/rpis/219560/?format=api",
        "https://catalogue.ceda.ac.uk/api/v2/rpis/219551/?format=api",
        "https://catalogue.ceda.ac.uk/api/v2/rpis/219552/?format=api",
        "https://catalogue.ceda.ac.uk/api/v2/rpis/219553/?format=api",
        "https://catalogue.ceda.ac.uk/api/v2/rpis/219554/?format=api",
        "https://catalogue.ceda.ac.uk/api/v2/rpis/219555/?format=api",
        "https://catalogue.ceda.ac.uk/api/v2/rpis/219556/?format=api",
        "https://catalogue.ceda.ac.uk/api/v2/rpis/219557/?format=api",
        "https://catalogue.ceda.ac.uk/api/v2/rpis/219559/?format=api",
        "https://catalogue.ceda.ac.uk/api/v2/rpis/219550/?format=api",
        "https://catalogue.ceda.ac.uk/api/v2/rpis/219558/?format=api"
    ],
    "procedureAcquisition": "https://catalogue.ceda.ac.uk/api/v2/acquisitions/45950/?format=api",
    "procedureCompositeProcess": null,
    "procedureComputation": null,
    "permissions": [
        {
            "ob_id": "https://catalogue.ceda.ac.uk/api/v2/observations/2522/?format=api",
            "useLimitation": null,
            "accessConstraints": null,
            "accessCategory": "registered",
            "accessRoles": null,
            "label": "registered: None group",
            "licenceURL": "http://www.nationalarchives.gov.uk/doc/open-government-licence/version/3/",
            "licenceClassifications": "any"
        }
    ],
    "discoveryKeywords": []
}