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

{
    "ob_id": 44244,
    "uuid": "e6251bf935304cfbb9c9269dc7757a35",
    "title": "GloSATMAT: monthly, global, gridded marine air temperature data",
    "abstract": "GloSATMAT is a global dataset of monthly mean marine air temperature that is produced on a 5° latitude by 5° longitude regular grid and covers the period since 1784.\r\n\r\nThe temperature values are taken from version 3.0.0 of the International Comprehensive Ocean-Atmosphere Data Set (ICOADS) for the period 1784-2014 and from version 3.0.2 of ICOADS thereafter. The in situ air temperature readings have been extracted from ICOADS and the ship data have been adjusted to reduce the effects of varying thermometer heights and to remove artificial diurnal heating biases. The data have been adjusted from their respective recording heights to a reference height of 2m. The air temperature readings have been subjected to a quality-control procedure and then the values have been aggregated to form gridded averages, with corresponding uncertainty estimates.\r\n\r\nThis dataset has been developed under the following NERC-funded projects: GloSAT (NE/S015647/2), CLASS (NE/R015953/1) and AtlantiS (NE/Y005589/1).",
    "keywords": "Marine,Temperature,Climate",
    "publicationState": "citable",
    "dataPublishedTime": "2025-05-14T14:47:12",
    "doiPublishedTime": "2025-05-14T15:13:13.751960",
    "updateFrequency": "notPlanned",
    "status": "ongoing",
    "result_field": {
        "ob_id": "https://api.catalogue.ceda.ac.uk/api/v2/observations/44250/?format=api",
        "dataPath": "/badc/deposited2025/GloSAT/GloSATMAT",
        "oldDataPath": [],
        "storageLocation": "internal",
        "storageStatus": "online",
        "volume": 2607396718,
        "numberOfFiles": 3099,
        "fileFormat": "NetCDF"
    },
    "timePeriod": "https://api.catalogue.ceda.ac.uk/api/v2/times/12380/?format=api",
    "geographicExtent": "https://api.catalogue.ceda.ac.uk/api/v2/bboxes/4779/?format=api",
    "nonGeographicFlag": false,
    "phenomena": [
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/29133/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/29134/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/29135/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/29136/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/31690/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/31691/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/31692/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/31693/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/50542/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/50543/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/60438/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/70766/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/70767/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/70775/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/75959/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/83974/?format=api"
    ],
    "dataLineage": "This dataset uses the same data processing as used in CLASSnmat v2. However, a diurnal adjustment has been applied to the data (after Cropper et al. 2023) that enables all-hours observations to be used (as opposed to nighttime-only in CLASSnmat). This allows the dataset to extend back to 1784.\r\n\r\nDetails of the data processing are documented in Morice et al. (2024).",
    "removedDataTime": null,
    "removedDataReason": "",
    "language": "English",
    "identifier_set": [
        "https://api.catalogue.ceda.ac.uk/api/v2/identifiers/13382/?format=api"
    ],
    "projects": [
        "https://api.catalogue.ceda.ac.uk/api/v2/projects/44102/?format=api"
    ],
    "observationcollection_set": [],
    "responsiblepartyinfo_set": [
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/211620/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/211592/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/211593/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/211594/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/211595/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/211596/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/211617/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/211591/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/211618/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/211619/?format=api"
    ],
    "procedureAcquisition": null,
    "procedureCompositeProcess": null,
    "procedureComputation": "https://api.catalogue.ceda.ac.uk/api/v2/computations/44252/?format=api",
    "permissions": [
        {
            "ob_id": "https://api.catalogue.ceda.ac.uk/api/v2/observations/2526/?format=api",
            "useLimitation": null,
            "accessConstraints": null,
            "accessCategory": "public",
            "accessRoles": null,
            "label": "public: None group",
            "licenceURL": "http://www.nationalarchives.gov.uk/doc/open-government-licence/version/3/",
            "licenceClassifications": "any"
        }
    ],
    "discoveryKeywords": []
}