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

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

{
    "ob_id": 12862,
    "uuid": "130450cdf1034235aa2a5107dc513d81",
    "title": "ESA Greenhouse Gases Climate Change Initiative (GHG_cci): GOSAT CO2 Level 2 Data Product (CO2_GOS_OCFP) version 5.2, generated with the OCFP (UoL-FP) algorithm",
    "abstract": "Part of the European Space Agency's (ESA) Greenhouse Gases (GHG) Climate Change Initiative (CCI) project, the XCO2 GOSAT product comprises a level 2, column-averaged dry-air mole fraction (mixing ratio) for carbon dioxide (CO2). The product has been produced using data acquired from the Thermal and Near Infrared Sensor for Carbon Observations (TANSO-FTS) NIR and SWIR spectra, onboard the Japanese Greenhouse gases Observing Satellite (GOSAT). The University of Leicester Full-Physics Retrieval Algorithm has been applied to the TANSO-FTS data, based on the original Orbiting Carbon Observatory (OCO) Full Physics Retrieval Algorithm and modified for use on GOSAT spectra. A second product has also been generated from the data using the SRFP algorithm, and the link to this product's record page is provided in the documentation section. \r\n\r\nThe XCO2 product is stored in NetCDF format with all GOSAT soundings on a single day stored in one file. For further information, including details of the OCFP algorithm and the TANSO-FTS instrument, please see the associated product user guide (PUG) in the documentation section or the Algorithm Theoretical Basis Document for version 5.1 of the product (no ATBD is yet available for version 5.2).",
    "keywords": "ESA, GHG, CCI, CO2, OCFP",
    "publicationState": "working",
    "dataPublishedTime": null,
    "doiPublishedTime": null,
    "updateFrequency": "",
    "status": "superseded",
    "result_field": {
        "ob_id": "https://api.catalogue.ceda.ac.uk/api/v2/observations/12863/?format=api",
        "dataPath": "/neodc/esacci/ghg/data/crdp_2/L2/GOSAT/CO2_GOS_OCFP/v5.2",
        "oldDataPath": [],
        "storageLocation": "internal",
        "storageStatus": "online",
        "volume": 1519903371,
        "numberOfFiles": 1680,
        "fileFormat": "The data is stored in NetCDF format which can be read with standard tools in the common\r\nprogramming languages (IDL, Matlab, Python etc)."
    },
    "timePeriod": "https://api.catalogue.ceda.ac.uk/api/v2/times/3604/?format=api",
    "geographicExtent": "https://api.catalogue.ceda.ac.uk/api/v2/bboxes/529/?format=api",
    "nonGeographicFlag": false,
    "phenomena": [
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/1050/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/1635/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/1636/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/11816/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/11852/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/11853/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/11854/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/11855/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/11856/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/11857/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/11858/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/11859/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/11860/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/11863/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/11864/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/11866/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/11867/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/11868/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/11869/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/11870/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/11871/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/11872/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/25159/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/25160/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/25161/?format=api"
    ],
    "dataLineage": "Data were processed by the ESA CCI GHG project team and supplied to CEDA as part of the ESA CCI Open Data Portal Project",
    "removedDataTime": null,
    "removedDataReason": "",
    "language": "English",
    "identifier_set": [],
    "projects": [
        "https://api.catalogue.ceda.ac.uk/api/v2/projects/13295/?format=api"
    ],
    "observationcollection_set": [
        "https://api.catalogue.ceda.ac.uk/api/v2/observationcollections/12808/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/observationcollections/30128/?format=api"
    ],
    "responsiblepartyinfo_set": [
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/49145/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/49142/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/49143/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/50851/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/140671/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/140672/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/140674/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/140673/?format=api"
    ],
    "procedureAcquisition": null,
    "procedureCompositeProcess": null,
    "procedureComputation": null,
    "permissions": [
        {
            "ob_id": "https://api.catalogue.ceda.ac.uk/api/v2/observations/2564/?format=api",
            "useLimitation": null,
            "accessConstraints": null,
            "accessCategory": "public",
            "accessRoles": null,
            "label": "public: None group",
            "licenceURL": "https://artefacts.ceda.ac.uk/licences/specific_licences/esacci_ghg_terms_and_conditions.pdf",
            "licenceClassifications": "any"
        }
    ],
    "discoveryKeywords": []
}