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

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

{
    "ob_id": 43235,
    "uuid": "6e329e32570d4d4f818b8f8aa18e7a85",
    "title": "EOCIS: Lake Catchment Change Indicators V1.0",
    "abstract": "This dataset contains Lake Catchment Change Indicators data produced within the Earth Observation Climate Information Service (EOCIS) project by Plymouth Marine Laboratory.\r\n\r\nThe Product(s) can be used to map daily variations in the reflectance of water bodies contained in the target lake catchment. The derived quantities turbidity and chlorophyll-a can be used to determine variability in the optical and biochemical conditions of the lake and other included water bodies. \r\n\r\nA set of vegetation, built-up area, and water indices are included to aid users in selection data ranges and locations of interest. These include the Normalized Difference Vegetation Index (NDVI), Normalized Difference Built-Up Index (NDBI) Augmented Normalized Difference Water Index (ANDWI) and Modified Normalized Difference Water Index (MDNWI).\r\n\r\nThese data sets have been created following the specific format for climate data at high resolution for the UK (CHUK) within the EOCIS project. The CHUK grid consists of 100m x 100m cells in British National Grid (BNG) projection. The CHUK grid covers the whole area of the British Isles, an area approximately 1,000km x 1,500km, whereas the data sets presented here are limited to parts of this grid for the extent of each lake catchment.",
    "keywords": "lake catchment,turbidity,chlorophyll,NDVI,NDBI,ANDWI,MDNWI,water-leaving reflectance,CHUK,EOCIS",
    "publicationState": "citable",
    "dataPublishedTime": "2025-04-04T14:14:11",
    "doiPublishedTime": "2025-04-04T16:05:57",
    "updateFrequency": "notPlanned",
    "status": "completed",
    "result_field": {
        "ob_id": "https://api.catalogue.ceda.ac.uk/api/v2/observations/43856/?format=api",
        "dataPath": "/neodc/eocis/data/CHUK/lake_catchment_indicators",
        "oldDataPath": [],
        "storageLocation": "internal",
        "storageStatus": "online",
        "volume": 153060046463,
        "numberOfFiles": 18982,
        "fileFormat": "NetCDF"
    },
    "timePeriod": "https://api.catalogue.ceda.ac.uk/api/v2/times/11943/?format=api",
    "geographicExtent": "https://api.catalogue.ceda.ac.uk/api/v2/bboxes/4623/?format=api",
    "nonGeographicFlag": false,
    "phenomena": [
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/3894/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/32072/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/46768/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/52664/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/52665/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/64875/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/80460/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/80463/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/84601/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/84602/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/84603/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/84604/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/84605/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/84606/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/84607/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/84608/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/84609/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/84610/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/84611/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/84612/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/84613/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/84614/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/84615/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/84616/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/84617/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/84618/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/84619/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/84620/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/84621/?format=api"
    ],
    "dataLineage": "This dataset was produced by Plymouth Marine Laboratory 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/13289/?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/209672/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/205653/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/205654/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/205655/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/205656/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/205657/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/205783/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/205652/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/205784/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/205785/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/205786/?format=api"
    ],
    "procedureAcquisition": null,
    "procedureCompositeProcess": "https://api.catalogue.ceda.ac.uk/api/v2/composites/43272/?format=api",
    "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": []
}