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

{
    "ob_id": 32619,
    "uuid": "b25d4a6174de4ac78000d034f500a268",
    "title": "ESA Permafrost Climate Change Initiative (Permafrost_cci):   Permafrost Ground Temperature for the Northern Hemisphere, v3.0",
    "abstract": "This dataset contains permafrost ground temperature data produced as part of the European Space Agency's (ESA) Climate Change Initiative (CCI) Permafrost project. It forms part of the second version of their Climate Research Data Package (CRDP v2). It is derived from a thermal model driven and constrained by satellite data. Grid products of CDRP v2 are released in annual files, covering the start to the end of the Julian year. This corresponds to average annual ground temperatures and is provided for specific depths (surface, 1m, 2m, 5m , 10m).\r\n\r\nCase A: This covers the Northern Hemisphere (north of 30°) for the period 2003-2019 based on MODIS Land Surface temperature merged with downscaled ERA5 reanalysis near-surface air temperature data.\r\nCase B: This covers the Northern Hemisphere (north of 30°) for the period 1997-2002 based on downscaled ERA5 reanalysis near-surface air temperature data which are bias-corrected with the Case A product for the overlap period 2003-2019 using a pixel-specific statistics for each day of the year.",
    "keywords": "Permafrost, CCI, Ground Temperature",
    "publicationState": "citable",
    "dataPublishedTime": "2021-06-25T16:59:05",
    "doiPublishedTime": "2021-06-28T12:36:20.964753",
    "updateFrequency": "notPlanned",
    "status": "completed",
    "result_field": {
        "ob_id": "https://api.catalogue.ceda.ac.uk/api/v2/observations/32620/?format=api",
        "dataPath": "/neodc/esacci/permafrost/data/ground_temperature/L4/area4/pp/v03.0/",
        "oldDataPath": [],
        "storageLocation": "internal",
        "storageStatus": "online",
        "volume": 35291367976,
        "numberOfFiles": 24,
        "fileFormat": "Data are netCDF formatted."
    },
    "timePeriod": "https://api.catalogue.ceda.ac.uk/api/v2/times/8999/?format=api",
    "geographicExtent": "https://api.catalogue.ceda.ac.uk/api/v2/bboxes/2567/?format=api",
    "nonGeographicFlag": false,
    "phenomena": [
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/27732/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/50416/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/50547/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/50548/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/70621/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/70622/?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/10897/?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/32783/?format=api"
    ],
    "responsiblepartyinfo_set": [
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/145417/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/145421/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/145420/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/145419/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/145416/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/145415/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/145422/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/145418/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/145423/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/145424/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/145425/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/145426/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/145427/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/145428/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/145429/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/145430/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/145431/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/145432/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/145433/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/145434/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/145435/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/145436/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/145437/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/145438/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/145439/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/145440/?format=api"
    ],
    "procedureAcquisition": null,
    "procedureCompositeProcess": null,
    "procedureComputation": "https://api.catalogue.ceda.ac.uk/api/v2/computations/32737/?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"
        }
    ]
}