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

{
    "ob_id": 32748,
    "uuid": "fdd90615b0df45489d9ca47708d98325",
    "title": "ESA Greenhouse Gases Climate Change Initiative (GHG_cci): Column-averaged methane from GOSAT-2, generated with the SRFP (RemoTeC) full physics retrieval algorithm, version 1.0.0",
    "abstract": "This dataset contains column-averaged dry-air mole fractions (mixing ratios) of methane (XCH4). It has been produced using data acquired from the Thermal and Near Infrared Sensor for Carbon Observations - Fourier Transform Spectrometer-2 (TANSO-FTS-2) Near Infrared (NIR) and Shortwave Infrared (SWIR) spectra, onboard the Japanese Greenhouse gases Observing Satellite (GOSAT-2), using the RemoTeC SRFP Full Physics Retrieval algorithm. Results are provided for the individual GOSAT-2 spatial footprints.\r\n\r\nThese data have been produced as part of the European Space Agency (ESA)'s Climate Change Initiative (CCI) programme.",
    "keywords": "ESA, CCI, satellite, atmosphere, carbon dioxide, CO2",
    "publicationState": "citable",
    "dataPublishedTime": "2021-09-02T17:12:21",
    "doiPublishedTime": "2021-09-08T10:42:24",
    "updateFrequency": "notPlanned",
    "status": "superseded",
    "result_field": {
        "ob_id": "https://api.catalogue.ceda.ac.uk/api/v2/observations/32749/?format=api",
        "dataPath": "/neodc/esacci/ghg/data/cci_plus/CH4_GO2_SRFP/v1.0/",
        "oldDataPath": [],
        "storageLocation": "internal",
        "storageStatus": "online",
        "volume": 266017657,
        "numberOfFiles": 249,
        "fileFormat": "Data are netCDF formatted."
    },
    "timePeriod": "https://api.catalogue.ceda.ac.uk/api/v2/times/8984/?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/11790/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/11791/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/11792/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/11793/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/11794/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/11795/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/11796/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/11797/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/11798/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/11800/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/11801/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/11802/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/11803/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/11804/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/11807/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/11808/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/11809/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/11810/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/11811/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/11812/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/11814/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/11815/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/11816/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/11817/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/11818/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/11819/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/11820/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/11822/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/11823/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/11846/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/13268/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/13270/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/13272/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/13273/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/36821/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/36822/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/36823/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/36825/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/36826/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/36827/?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.      These data have been produced as part of the European Space Agency (ESA)'s Climate Change Initiative (CCI+) programme.",
    "removedDataTime": null,
    "removedDataReason": "",
    "language": "English",
    "identifier_set": [
        "https://api.catalogue.ceda.ac.uk/api/v2/identifiers/10941/?format=api"
    ],
    "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/146132/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/146126/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/146133/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/146131/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/146130/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/146129/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/146127/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/146994/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/146995/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/146996/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/146997/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/146998/?format=api"
    ],
    "procedureAcquisition": null,
    "procedureCompositeProcess": "https://api.catalogue.ceda.ac.uk/api/v2/composites/32861/?format=api",
    "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"
        },
        {
            "ob_id": 1140,
            "name": "ESACCI"
        }
    ]
}