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

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

{
    "ob_id": 14563,
    "uuid": "3c098ba124a347678a00b0102bab9f0a",
    "title": "ESA Greenhouse Gases Climate Change Initiative (GHG CCI): GOSAT CO2 Level 2 Data Product (CO2_GOS_OCFP) version 6.0, 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, generated using the SRFP algorithm, is also available.\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.\r\n\r\nThe GHG-CCI team encourage all users of their products to register with them to receive information on any updates or issues regarding the data products and to receive notification of new product releases. To register, please use the following link: http://www.iup.uni-bremen.de/sciamachy/NIR_NADIR_WFM_DOAS/CRDP_REG/",
    "keywords": "ESA, GHG, CCI, CO2, Greenhouse Gas",
    "publicationState": "published",
    "dataPublishedTime": "2016-04-11T08:24:38",
    "doiPublishedTime": null,
    "updateFrequency": "",
    "status": "superseded",
    "result_field": {
        "ob_id": "https://api.catalogue.ceda.ac.uk/api/v2/observations/14564/?format=api",
        "dataPath": "/neodc/esacci/ghg/data/crdp_3/GOSAT/CO2_GOS_OCFP/6.0/",
        "oldDataPath": [],
        "storageLocation": "internal",
        "storageStatus": "online",
        "volume": 1750570356,
        "numberOfFiles": 2008,
        "fileFormat": "Data are in NetCDF format"
    },
    "timePeriod": "https://api.catalogue.ceda.ac.uk/api/v2/times/3846/?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/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/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/68630/?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/68646/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/69372/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/69373/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/69374/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/69375/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/69801/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/69802/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/69803/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/69804/?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/56472/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/56471/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/56470/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/56469/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/104888/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/105102/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/105281/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/56561/?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": [
        {
            "ob_id": 1138,
            "name": "NDGO0003"
        }
    ]
}