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

{
    "ob_id": 41270,
    "uuid": "d34330ce3f604e368c06d76de1987ce5",
    "title": "ESA Permafrost Climate Change Initiative (Permafrost_cci): Permafrost active layer thickness for the Northern Hemisphere, v4.0",
    "abstract": "This dataset contains v4.0 permafrost active layer thickness data produced as part of the European Space Agency's (ESA) Climate Change Initiative (CCI) Permafrost project. It forms part of the third version of their Climate Research Data Package (CRDP v3). It is derived from a thermal model driven and constrained by satellite data. CRDPv3 covers the years from 1997 to 2021. Grid products of CDRP v3 are released in annual files, covering the start  to the end of the Julian year. The maximum depth of seasonal thaw is provided, which corresponds to the active layer thickness.  \r\n\r\nCase A: It covers the Northern Hemisphere (north of 30°) for the period 2003-2021 based on MODIS \r\nLand Surface temperature merged with downscaled ERA5 reanalysis near-surface air temperature data. \r\nCase B: It covers the Northern Hemisphere (north of 30°) for the period 1997-2002 based on downscaled \r\nERA5 reanalysis near-surface air temperature data which are bias-corrected with the Case A product for \r\nthe overlap period 2003-2021 using a pixel-specific statistics for each day of the year.",
    "keywords": "Permafrost, CCI, Active layer thickness",
    "publicationState": "citable",
    "dataPublishedTime": "2024-04-03T13:06:32",
    "doiPublishedTime": "2024-04-24T11:15:53",
    "updateFrequency": "notPlanned",
    "status": "completed",
    "result_field": {
        "ob_id": "https://api.catalogue.ceda.ac.uk/api/v2/observations/41277/?format=api",
        "dataPath": "/neodc/esacci/permafrost/data/active_layer_thickness/L4/area4/pp/v04.0",
        "oldDataPath": [],
        "storageLocation": "internal",
        "storageStatus": "online",
        "volume": 867946695,
        "numberOfFiles": 26,
        "fileFormat": "NetCDF"
    },
    "timePeriod": "https://api.catalogue.ceda.ac.uk/api/v2/times/12927/?format=api",
    "geographicExtent": "https://api.catalogue.ceda.ac.uk/api/v2/bboxes/4080/?format=api",
    "nonGeographicFlag": false,
    "phenomena": [
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/32072/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/62645/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/62780/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/62781/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/70620/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/75342/?format=api"
    ],
    "dataLineage": "Data have been produced by the ESA CCI Permafrost project as part of ESA's Climate Change Initiative programme",
    "removedDataTime": null,
    "removedDataReason": "",
    "language": "English",
    "identifier_set": [
        "https://api.catalogue.ceda.ac.uk/api/v2/identifiers/12861/?format=api"
    ],
    "projects": [
        "https://api.catalogue.ceda.ac.uk/api/v2/projects/29966/?format=api"
    ],
    "observationcollection_set": [
        "https://api.catalogue.ceda.ac.uk/api/v2/observationcollections/41567/?format=api"
    ],
    "responsiblepartyinfo_set": [
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/200898/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/200905/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/200903/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/200902/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/200901/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/200900/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/200899/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/200897/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/200906/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/200907/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/200908/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/200909/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/200910/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/200911/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/200912/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/200913/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/200915/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/200916/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/200917/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/200918/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/200919/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/202923/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/200921/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/202924/?format=api"
    ],
    "procedureAcquisition": null,
    "procedureCompositeProcess": null,
    "procedureComputation": "https://api.catalogue.ceda.ac.uk/api/v2/computations/41455/?format=api",
    "permissions": [
        {
            "ob_id": "https://api.catalogue.ceda.ac.uk/api/v2/observations/2596/?format=api",
            "useLimitation": null,
            "accessConstraints": null,
            "accessCategory": "public",
            "accessRoles": null,
            "label": "public: None group",
            "licenceURL": "https://artefacts.ceda.ac.uk/licences/specific_licences/esacci_permafrost_terms_and_conditions.pdf",
            "licenceClassifications": ""
        }
    ],
    "discoveryKeywords": [
        {
            "ob_id": 1138,
            "name": "NDGO0003"
        },
        {
            "ob_id": 1140,
            "name": "ESACCI"
        }
    ]
}