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

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

{
    "ob_id": 46124,
    "uuid": "8209b9acb92e4ba69188c9c8ff7a3b76",
    "title": "University of Leicester GOSAT-2 Proxy XCH4, v2.0",
    "abstract": "The University of Leicester GOSAT-2 Proxy XCH4, v2.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 the University of Leicester GOSAT-2 Proxy XCH4 v2.0 dataset. This dataset is consistent with the GOSAT dataset (https://catalogue.ceda.ac.uk/uuid/94d6572a308e477c86e0ce7c4d771311/) 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). \r\n\r\nWe bias-correct this data to be consistent with the GOSAT dataset and evaluate it’s performance against the the Total Carbon Column Observing Network via the same methodology as used for the GOSAT data. See process information and documentation for further details.",
    "keywords": "GOSAT-2, CH4, Methane, EOCIS",
    "publicationState": "citable",
    "dataPublishedTime": "2026-08-10T15:04:45",
    "doiPublishedTime": "2026-08-26T14:19:27.110628",
    "updateFrequency": "notPlanned",
    "status": "ongoing",
    "result_field": {
        "ob_id": "https://catalogue.ceda.ac.uk/api/v2/observations/46166/?format=api",
        "dataPath": "/neodc/gosat/data/ch4/UoL_gosat2_v2/CH4_GOSAT2_OCPR/v2.0/",
        "oldDataPath": [],
        "storageLocation": "internal",
        "storageStatus": "online",
        "volume": 5189138496,
        "numberOfFiles": 2383,
        "fileFormat": "Data are in NetCDF format"
    },
    "timePeriod": "https://catalogue.ceda.ac.uk/api/v2/times/13298/?format=api",
    "geographicExtent": "https://catalogue.ceda.ac.uk/api/v2/bboxes/529/?format=api",
    "nonGeographicFlag": false,
    "phenomena": [
        "https://catalogue.ceda.ac.uk/api/v2/phenomona/50542/?format=api",
        "https://catalogue.ceda.ac.uk/api/v2/phenomona/50543/?format=api",
        "https://catalogue.ceda.ac.uk/api/v2/phenomona/63576/?format=api",
        "https://catalogue.ceda.ac.uk/api/v2/phenomona/66452/?format=api",
        "https://catalogue.ceda.ac.uk/api/v2/phenomona/66456/?format=api",
        "https://catalogue.ceda.ac.uk/api/v2/phenomona/68622/?format=api",
        "https://catalogue.ceda.ac.uk/api/v2/phenomona/68623/?format=api",
        "https://catalogue.ceda.ac.uk/api/v2/phenomona/68624/?format=api",
        "https://catalogue.ceda.ac.uk/api/v2/phenomona/68625/?format=api",
        "https://catalogue.ceda.ac.uk/api/v2/phenomona/68626/?format=api",
        "https://catalogue.ceda.ac.uk/api/v2/phenomona/68627/?format=api",
        "https://catalogue.ceda.ac.uk/api/v2/phenomona/68628/?format=api",
        "https://catalogue.ceda.ac.uk/api/v2/phenomona/68629/?format=api",
        "https://catalogue.ceda.ac.uk/api/v2/phenomona/68630/?format=api",
        "https://catalogue.ceda.ac.uk/api/v2/phenomona/68631/?format=api",
        "https://catalogue.ceda.ac.uk/api/v2/phenomona/68632/?format=api",
        "https://catalogue.ceda.ac.uk/api/v2/phenomona/68633/?format=api",
        "https://catalogue.ceda.ac.uk/api/v2/phenomona/68634/?format=api",
        "https://catalogue.ceda.ac.uk/api/v2/phenomona/68635/?format=api",
        "https://catalogue.ceda.ac.uk/api/v2/phenomona/68636/?format=api",
        "https://catalogue.ceda.ac.uk/api/v2/phenomona/68637/?format=api",
        "https://catalogue.ceda.ac.uk/api/v2/phenomona/68638/?format=api",
        "https://catalogue.ceda.ac.uk/api/v2/phenomona/68639/?format=api",
        "https://catalogue.ceda.ac.uk/api/v2/phenomona/68640/?format=api",
        "https://catalogue.ceda.ac.uk/api/v2/phenomona/68641/?format=api",
        "https://catalogue.ceda.ac.uk/api/v2/phenomona/68642/?format=api",
        "https://catalogue.ceda.ac.uk/api/v2/phenomona/68643/?format=api",
        "https://catalogue.ceda.ac.uk/api/v2/phenomona/68644/?format=api",
        "https://catalogue.ceda.ac.uk/api/v2/phenomona/68645/?format=api",
        "https://catalogue.ceda.ac.uk/api/v2/phenomona/68646/?format=api",
        "https://catalogue.ceda.ac.uk/api/v2/phenomona/103077/?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 under the National Centre for Earth Observation (NCEO).",
    "removedDataTime": null,
    "removedDataReason": "",
    "language": "English",
    "identifier_set": [
        "https://catalogue.ceda.ac.uk/api/v2/identifiers/13960/?format=api"
    ],
    "projects": [
        "https://catalogue.ceda.ac.uk/api/v2/projects/5002/?format=api"
    ],
    "observationcollection_set": [],
    "responsiblepartyinfo_set": [
        "https://catalogue.ceda.ac.uk/api/v2/rpis/220311/?format=api",
        "https://catalogue.ceda.ac.uk/api/v2/rpis/220312/?format=api",
        "https://catalogue.ceda.ac.uk/api/v2/rpis/220313/?format=api",
        "https://catalogue.ceda.ac.uk/api/v2/rpis/220305/?format=api",
        "https://catalogue.ceda.ac.uk/api/v2/rpis/220306/?format=api",
        "https://catalogue.ceda.ac.uk/api/v2/rpis/220314/?format=api",
        "https://catalogue.ceda.ac.uk/api/v2/rpis/220307/?format=api",
        "https://catalogue.ceda.ac.uk/api/v2/rpis/220308/?format=api",
        "https://catalogue.ceda.ac.uk/api/v2/rpis/220309/?format=api",
        "https://catalogue.ceda.ac.uk/api/v2/rpis/220310/?format=api",
        "https://catalogue.ceda.ac.uk/api/v2/rpis/220315/?format=api",
        "https://catalogue.ceda.ac.uk/api/v2/rpis/220316/?format=api",
        "https://catalogue.ceda.ac.uk/api/v2/rpis/220317/?format=api"
    ],
    "procedureAcquisition": null,
    "procedureCompositeProcess": "https://catalogue.ceda.ac.uk/api/v2/composites/46168/?format=api",
    "procedureComputation": null,
    "permissions": [
        {
            "ob_id": "https://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, attribution required"
        }
    ],
    "discoveryKeywords": []
}