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

{
    "ob_id": 12968,
    "uuid": "b3ae3b0d11c9481bab3c9c914a6c80aa",
    "title": "ESA Greenhouse Gases Climate Change Initiative (GHG_cci): SCIAMACHY CO2 Level 2 Data Product (CO2_SCI_BESD), version 02.00.08, generated with the BESD algorithm",
    "abstract": "Part of the European Space Agency's (ESA) Greenhouse Gases (GHG) Climate Change Initiative (CCI) project and the Climate Research Data Package Number 2 (CRDP#2), the BESD XCO2 SCIAMACHY 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 SCanning Imaging Absorption spectroMeter for Atmospheric CHartographY (SCIAMACHY) on board the European Space Agency's environmental research satellite ENVISAT. \r\n\r\nThis product has been produced with the Bremen Optimal Estimation DOAS (BESD) algorithm, a full physics algorithm which uses measurements in the O2-A absorption band to retrieve scattering information of clouds and aerosols. This is the GHG CCI baseline algorithm for deriving SCIAMACHY XCO2 data:  A product has also been generated from the SCIAMACHY data using an alternative algorithm: the WFMD algorithm, the link to this product's record page being provided in the documentation section. It is advised that users who aren't sure whether to use the baseline or alternative product use this product generated with the BESD baseline algorithm. For more information regarding the differences between baseline and alternative algorithms please see the GHG-CCI data products webpage in the documentation section. \r\n\r\nFor further information on the product, including details of the BESD algorithm and the SCIAMACHY instrument, please see the associated product user guide (PUG) or the Algorithm Theoretical Basis Documents in the documentation section.",
    "keywords": "ESA, GHG, GREENHOUSE GASES, CCI, CO2, SCIAMACHY, BESD",
    "publicationState": "working",
    "dataPublishedTime": null,
    "doiPublishedTime": null,
    "updateFrequency": "",
    "status": "superseded",
    "result_field": {
        "ob_id": "https://api.catalogue.ceda.ac.uk/api/v2/observations/13299/?format=api",
        "dataPath": "/neodc/esacci/ghg/data/crdp_2/L2/SCIAMACHY/CO2_SCI_BESD/v02.00.08",
        "oldDataPath": [],
        "storageLocation": "internal",
        "storageStatus": "online",
        "volume": 801556731,
        "numberOfFiles": 3198,
        "fileFormat": "Data in NetCDF format"
    },
    "timePeriod": "https://api.catalogue.ceda.ac.uk/api/v2/times/3602/?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/50416/?format=api",
        "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/55527/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/55529/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/55531/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/55532/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/55533/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/55534/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/55535/?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"
    ],
    "responsiblepartyinfo_set": [
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/49682/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/49681/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/49679/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/49680/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/140688/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/140689/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/140691/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/140690/?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": []
}