GET

Observation Instance

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/30054/?format=api
HTTP 200 OK
Allow: GET, HEAD, OPTIONS
Content-Type: application/json
Vary: Accept

{
    "ob_id": 30054,
    "uuid": "18ef8247f52a4cb6a14013f8235cc1eb",
    "title": "University of Leicester GOSAT Proxy XCH4 v9.0",
    "abstract": "The University of Leicester GOSAT Proxy XCH4 v9.0 data set contains column-averaged dry-air mole fraction of methane (XCH4) generated from the Greenhouse Gas Observing Satellite (GOSAT) 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 NCEO funded update/extension to the European Space Agency Climate Change Initiative (CCI) CH4_GOS_OCPR V7.0. and the Copernicus Climate Change Service (C3S)  CH_4 v7.2 data sets. It's a full reprocessing, based on different underlying L1B radiance data with additional changes.  The latest version of the GOSAT Level 1B files (version 210.210) was acquired directly from the National Institute for Environmental Studies (NIES) GOSAT Data Archive Service (GDAS) Data Server and are 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. These measured radiances have the recommended radiometric calibration and degradation corrections applied as per Yoshida et al., 2013 with an estimate of the spectral noise derived from the standard deviation of the out-of-band signal. The spectral data were then inputted into 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. See process information and documentation for further details.",
    "keywords": "GOSAT, CH4, Methane",
    "publicationState": "citable",
    "dataPublishedTime": "2020-05-07T16:04:50",
    "doiPublishedTime": "2020-05-07T16:16:37",
    "updateFrequency": "notPlanned",
    "status": "ongoing",
    "result_field": {
        "ob_id": "https://api.catalogue.ceda.ac.uk/api/v2/observations/30281/?format=api",
        "dataPath": "/neodc/gosat/data/ch4/nceov1.0/CH4_GOS_OCPR/",
        "oldDataPath": [],
        "storageLocation": "internal",
        "storageStatus": "online",
        "volume": 19479912781,
        "numberOfFiles": 4530,
        "fileFormat": "CF compliant NetCDF"
    },
    "timePeriod": "https://api.catalogue.ceda.ac.uk/api/v2/times/8244/?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/55535/?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/66719/?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",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/69629/?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 produce under NCEO grant nceo020005",
    "removedDataTime": null,
    "removedDataReason": "",
    "language": "English",
    "identifier_set": [
        "https://api.catalogue.ceda.ac.uk/api/v2/identifiers/10713/?format=api"
    ],
    "projects": [
        "https://api.catalogue.ceda.ac.uk/api/v2/projects/5002/?format=api"
    ],
    "observationcollection_set": [
        "https://api.catalogue.ceda.ac.uk/api/v2/observationcollections/30127/?format=api"
    ],
    "responsiblepartyinfo_set": [
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/130869/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/130870/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/130872/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/130863/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/130874/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/130867/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/130866/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/130865/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/130868/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/130871/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/130873/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/130864/?format=api"
    ],
    "procedureAcquisition": null,
    "procedureCompositeProcess": "https://api.catalogue.ceda.ac.uk/api/v2/composites/30282/?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": [
        {
            "ob_id": 1138,
            "name": "NDGO0003"
        }
    ]
}