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

{
    "ob_id": 29992,
    "uuid": "f717a8ea622f495397f4e76f777349d1",
    "title": "STFC RAL methane retrievals from IASI on board MetOp-A, version 2.0",
    "abstract": "This Infrared Atmospheric Sounding Interferometer (IASI) methane dataset contains height-resolved and column-averaged volume mixing ratios of atmospheric methane (CH4). It also includes column-averaged water vapour (H2O), a scale factor for the HDO (water vapour isotopologue) volume mixing ratio profile, surface temperature, effective cloud fraction, effective cloud-top pressure and scale factors for two systematic residual spectra which are jointly retrieved from the spectral range 1232.25-1290.00 cm-1 by the Rutherford Appleton Laboratory (RAL) IASI optimal estimation methane retrieval scheme. The dataset additionally contains selected a priori values and uncertainties adopted in the optimal estimation scheme and retrieval output diagnostics such as the retrieval cost and the averaging kernels.\r\n\r\nThis work was funded by the National Centre for Earth Observation (NCEO) under the UK Natural Environment Research Council (NERC) with additional funding from EUMETSAT.\r\n\r\nData were produced by the United Kingdom Research and Innnovation (UKRI) Science and Technology Facilities Council (STFC) Remote Sensing Group (RSG) at the Rutherford Appleton Laboratory (RAL).\r\n\r\nThis is version 2.0 of the dataset.",
    "keywords": "methane, IASI, optimal estimation, retrieval, averaging kernels, assimilation",
    "publicationState": "citable",
    "dataPublishedTime": "2020-02-25T13:35:49",
    "doiPublishedTime": "2020-03-10T14:06:11.939534",
    "updateFrequency": "notPlanned",
    "status": "completed",
    "result_field": {
        "ob_id": "https://api.catalogue.ceda.ac.uk/api/v2/observations/30119/?format=api",
        "dataPath": "/neodc/iasi_ch4_ral/data/metop-a/l2/tir/v2.0/",
        "oldDataPath": [],
        "storageLocation": "internal",
        "storageStatus": "online",
        "volume": 1148805035519,
        "numberOfFiles": 828516,
        "fileFormat": "Data are in NetCDF format."
    },
    "timePeriod": "https://api.catalogue.ceda.ac.uk/api/v2/times/8153/?format=api",
    "geographicExtent": "https://api.catalogue.ceda.ac.uk/api/v2/bboxes/1/?format=api",
    "nonGeographicFlag": false,
    "phenomena": [
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/61970/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/61971/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/61972/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/61973/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/61977/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/61978/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/61979/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/61980/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/61981/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/61984/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/61985/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/61986/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/61987/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/61988/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/61989/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/61990/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/61991/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/61992/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/61993/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/61994/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/61995/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/62000/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/62002/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/62004/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/68548/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/68549/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/68550/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/68551/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/68552/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/68553/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/68554/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/68555/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/68556/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/68557/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/68558/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/68559/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/68560/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/68561/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/68562/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/68563/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/68564/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/68565/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/68566/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/68567/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/68568/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/68569/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/68570/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/68571/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/68572/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/68573/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/68574/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/68575/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/68576/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/68577/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/68578/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/68579/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/68580/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/82409/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/82411/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/82418/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/82419/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/82421/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/82422/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/82423/?format=api"
    ],
    "dataLineage": "Data produced by the Rutherford Appleton Laboratory (RAL) Remote Sensing Group (RSG) at the United Kingdom Research and Innovation (UKRI) Science and Technology Facilities Council (STFC).  The development of the Infrared Atmospheric Sounding Interferometer (IASI) offline thermal-IR methane retrieval was funded by the Natural Environment Research Council (NERC) through its National Centre for Earth Observation (NCEO) with additional funding from EUMETSAT.",
    "removedDataTime": null,
    "removedDataReason": "",
    "language": "English",
    "identifier_set": [
        "https://api.catalogue.ceda.ac.uk/api/v2/identifiers/10701/?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/14469/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/observationcollections/30127/?format=api"
    ],
    "responsiblepartyinfo_set": [
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/129605/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/129601/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/129602/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/129603/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/129604/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/129606/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/129607/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/129610/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/129611/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/129612/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/129613/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/129614/?format=api"
    ],
    "procedureAcquisition": null,
    "procedureCompositeProcess": "https://api.catalogue.ceda.ac.uk/api/v2/composites/14467/?format=api",
    "procedureComputation": null,
    "permissions": [
        {
            "ob_id": "https://api.catalogue.ceda.ac.uk/api/v2/observations/2522/?format=api",
            "useLimitation": null,
            "accessConstraints": null,
            "accessCategory": "registered",
            "accessRoles": null,
            "label": "registered: None group",
            "licenceURL": "http://www.nationalarchives.gov.uk/doc/open-government-licence/version/3/",
            "licenceClassifications": "any"
        }
    ],
    "discoveryKeywords": [
        {
            "ob_id": 1138,
            "name": "NDGO0003"
        }
    ]
}