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

{
    "ob_id": 41456,
    "uuid": "d32244e674dd438ca4d321560daad755",
    "title": "ESA River Discharge Climate Change Initiative (RD_cci): Combined river discharge product, v1.0",
    "abstract": "This dataset contains river discharge (Q) data in cubic meters per second (m3/s) from the ESA Climate Change Initiative River Discharge project (RD_cci).\r\n\r\nThese river discharge time series have been computed at different locations by the combination of data derived from satellite altimeters and multispectral sensors. Two levels of combination are implemented based on the original products: Level-2, in which the data has been derived by merging multi-mission multispectral time series (called CM) and the water level product derived by radar altimeters (called Altimetry),  and Level-3, in which the river discharge products obtained from altimeters and multispectral sensors are used. The river discharges are derived following several approaches:\r\n\r\n1) L2 Merged river discharge:\r\n\r\na) COPULA Altimetry – CM: by a bivariate cumulative distribution function (CDF) which is applied between the multispectral indices and the water level from altimetry to get their joint probability distribution. \r\n\r\nb) RIDESAT Altimetry - CM: by a three-parameter non-linear relationship that merges the multispectral indices and the water level from altimetry\r\n\r\n\r\n2) L3 Merged river discharge:\r\n\r\na) Altimetry - CM cal_BestFIT: by the combination of river discharges obtained by the procedure of BestFIT applied to the multispectral and river discharges obtained by the altimetry through a weighted approach\r\n\r\nb) Altimetry – CM cal_Copula: by the combination of river discharges obtained by the procedure of Copula applied to the multispectral and river discharges obtained by the altimetry through a weighted approach\r\n\r\nc) Altimetry – CM uncal_CDF: by the combination of river discharges obtained by the procedure of CDF applied to the multispectral and the altimetry through a weighted approach",
    "keywords": "river discharge, CCI",
    "publicationState": "citable",
    "dataPublishedTime": "2024-11-28T19:11:39",
    "doiPublishedTime": "2024-11-28T22:58:59",
    "updateFrequency": "notPlanned",
    "status": "completed",
    "result_field": {
        "ob_id": "https://api.catalogue.ceda.ac.uk/api/v2/observations/43214/?format=api",
        "dataPath": "/neodc/esacci/river_discharge/data/RD/RD-combined/v1.0/",
        "oldDataPath": [],
        "storageLocation": "internal",
        "storageStatus": "online",
        "volume": 13870715,
        "numberOfFiles": 151,
        "fileFormat": "Data are in both CSV and NetCDF format"
    },
    "timePeriod": "https://api.catalogue.ceda.ac.uk/api/v2/times/11890/?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/50559/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/50561/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/63576/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/75233/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/75235/?format=api"
    ],
    "dataLineage": "Data were produced by the project team and supplied for archiving at the Centre for Environmental Data Analysis (CEDA).",
    "removedDataTime": null,
    "removedDataReason": "",
    "language": "English",
    "identifier_set": [
        "https://api.catalogue.ceda.ac.uk/api/v2/identifiers/13210/?format=api"
    ],
    "projects": [
        "https://api.catalogue.ceda.ac.uk/api/v2/projects/41537/?format=api"
    ],
    "observationcollection_set": [],
    "responsiblepartyinfo_set": [
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/205537/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/202094/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/202095/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/202096/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/202097/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/202098/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/205534/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/202093/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/205535/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/205536/?format=api"
    ],
    "procedureAcquisition": null,
    "procedureCompositeProcess": "https://api.catalogue.ceda.ac.uk/api/v2/composites/43213/?format=api",
    "procedureComputation": null,
    "permissions": [
        {
            "ob_id": "https://api.catalogue.ceda.ac.uk/api/v2/observations/2612/?format=api",
            "useLimitation": null,
            "accessConstraints": null,
            "accessCategory": "public",
            "accessRoles": null,
            "label": "public: None group",
            "licenceURL": "https://artefacts.ceda.ac.uk/licences/specific_licences/esacci_river_discharge_terms_and_conditions.pdf",
            "licenceClassifications": "any"
        }
    ],
    "discoveryKeywords": [
        {
            "ob_id": 1140,
            "name": "ESACCI"
        }
    ]
}