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

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

{
    "ob_id": 43579,
    "uuid": "e7e4499f7f32493db96635026b95ded8",
    "title": "EOCIS:  University of Leicester GOSAT-2 Proxy XCH4, v1.0",
    "abstract": "The University of Leicester GOSAT-2 Proxy XCH4, v1.0 data set contains column-averaged dry-air mole fraction of methane (XCH4) generated from the Greenhouse Gas Observing Satellite (GOSAT-2) Level 1B data using the University of Leicester Full-Physics retrieval scheme (UoL-FP) using the Proxy retrieval approach.\r\n\r\nThis data is an Earth Observation Climate Information Service (EOCIS) funded version of the NCEO GOSAT-2 Proxy XCH4 v1.0 dataset. This dataset is consistent with the GOSAT-1 dataset (https://catalogue.ceda.ac.uk/uuid/54df57f3aaed4867bec35ebdb31f4a8b/) The latest version of the GOSAT-2 Level 1B files were processed with the Leicester Retrieval Preparation Toolset to extract the measured radiances along with all required sounding-specific ancillary information such as the measurement time, location and geometry. The data were processed through the UoL-FP retrieval algorithm where the Proxy retrieval approach is used to obtain the column-averaged dry-air mole fraction of methane (XCH4). Post-filtering and bias correction against the Total Carbon Column Observing Network is then performed, via the same methodology as used for the GOSAT-1 data. See process information and documentation for further details.",
    "keywords": "GOSAT-2, CH4, Methane, EOCIS",
    "publicationState": "citable",
    "dataPublishedTime": "2025-08-08T14:55:56",
    "doiPublishedTime": "2025-08-11T08:47:56",
    "updateFrequency": "notPlanned",
    "status": "completed",
    "result_field": {
        "ob_id": "https://api.catalogue.ceda.ac.uk/api/v2/observations/43854/?format=api",
        "dataPath": "/neodc/eocis/data/global_and_regional/methane/gosat2/CH4_GO2_OCPR/L2/v1.0/",
        "oldDataPath": [],
        "storageLocation": "internal",
        "storageStatus": "online",
        "volume": 4988876768,
        "numberOfFiles": 1702,
        "fileFormat": "Data are in NetCDF format"
    },
    "timePeriod": "https://api.catalogue.ceda.ac.uk/api/v2/times/12260/?format=api",
    "geographicExtent": "https://api.catalogue.ceda.ac.uk/api/v2/bboxes/2620/?format=api",
    "nonGeographicFlag": false,
    "phenomena": [
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/50542/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/50543/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/63576/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/66452/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/66456/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/68622/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/68623/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/68624/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/68625/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/68626/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/68627/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/68628/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/68629/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/68630/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/68631/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/68632/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/68633/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/68634/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/68635/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/68636/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/68637/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/68638/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/68639/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/68640/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/68641/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/68642/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/68643/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/68644/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/68645/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/68646/?format=api"
    ],
    "dataLineage": "Data were produced by the University of Leicester project team and delivered to Centre for Environmental Data Analysis (CEDA) for archival and publication. The data was produced as part of the Earth Observation Climate Information Service (EOCIS) project (grant number NE/X019071/1).",
    "removedDataTime": null,
    "removedDataReason": "",
    "language": "English",
    "identifier_set": [
        "https://api.catalogue.ceda.ac.uk/api/v2/identifiers/13490/?format=api"
    ],
    "projects": [
        "https://api.catalogue.ceda.ac.uk/api/v2/projects/5002/?format=api",
        "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/208065/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/208066/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/208067/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/208068/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/208069/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/208070/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/208071/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/208072/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/208073/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/208074/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/208076/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/209670/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/209671/?format=api"
    ],
    "procedureAcquisition": null,
    "procedureCompositeProcess": "https://api.catalogue.ceda.ac.uk/api/v2/composites/43582/?format=api",
    "procedureComputation": null,
    "permissions": [
        {
            "ob_id": "https://api.catalogue.ceda.ac.uk/api/v2/observations/2526/?format=api",
            "useLimitation": null,
            "accessConstraints": null,
            "accessCategory": "public",
            "accessRoles": null,
            "label": "public: None group",
            "licenceURL": "http://www.nationalarchives.gov.uk/doc/open-government-licence/version/3/",
            "licenceClassifications": "any"
        }
    ],
    "discoveryKeywords": []
}