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

{
    "ob_id": 44293,
    "uuid": "e0ca70c643264ea0a68d04008499b87d",
    "title": "HadISDH.land: gridded global monthly land surface humidity data version 4.6.1.2024f",
    "abstract": "This is the HadISDH.land 4.6.1.2024f version of the Met Office Hadley Centre Integrated Surface Dataset of Humidity (HadISDH). HadISDH.land is a near-global gridded monthly mean land surface humidity climate monitoring product. It is created from in situ observations of air temperature and dew point temperature from weather stations. The observations have been quality controlled and homogenised. Uncertainty estimates for observation issues and gridbox sampling are provided (see data quality statement section below). The data are provided by the Met Office Hadley Centre and this version spans 1/1/1973 to 31/12/2024.  \r\n\r\nThe data are monthly gridded (5 degree by 5 degree) fields. Products are available for temperature and six humidity variables: specific humidity (q), relative humidity (RH), dew point temperature (Td), wet bulb temperature (Tw), vapour pressure (e), dew point depression (DPD).\r\n\r\nThis version extends the previous version to the end of 2024. Users are advised to read the update document in the Docs section for full details on all changes from the previous release.\r\n\r\nAs in previous years, the annual scrape of NOAAs Integrated Surface Dataset for HadISD.3.4.1.2024f, which is the basis of HadISDH.land, has pulled through some historical changes to stations. This, and the additional year of data, results in small changes to station selection. The homogeneity adjustments differ slightly due to sensitivity to the addition and loss of stations, historical changes to stations previously included and the additional 12 months of data.\r\n\r\nTo keep informed about updates, news and announcements follow the HadOBS team on twitter @metofficeHadOBS.\r\n\r\nFor more detailed information e.g bug fixes, routine updates and other exploratory analysis, see the HadISDH blog: http://hadisdh.blogspot.co.uk/\r\n\r\nReferences:\r\n\r\nWhen using the dataset in a paper please cite the following papers (see Docs for link\r\nto the publications) and this dataset (using the \"citable as\" reference):\r\n\r\nWillett, K. M., Dunn, R. J. H., Thorne, P. W., Bell, S., de Podesta, M., Parker, D. E.,\r\nJones, P. D., and Williams Jr., C. N.: HadISDH land surface multi-variable humidity and\r\ntemperature record for climate monitoring, Clim. Past, 10, 1983-2006,\r\ndoi:10.5194/cp-10-1983-2014, 2014.\r\n\r\nDunn, R. J. H., et al. 2016: Expanding HadISD: quality-controlled, sub-daily station\r\ndata from 1931, Geoscientific Instrumentation, Methods and Data Systems, 5, 473-491.\r\n\r\nSmith, A., N. Lott, and R. Vose, 2011: The Integrated Surface Database: Recent\r\nDevelopments and Partnerships. Bulletin of the American Meteorological Society, 92,\r\n704-708, doi:10.1175/2011BAMS3015.1\r\n\r\nWe strongly recommend that you read these papers before making use of the data, more\r\ndetail on the dataset can be found in an earlier publication:\r\n\r\nWillett, K. M., Williams Jr., C. N., Dunn, R. J. H., Thorne, P. W., Bell, S., de\r\nPodesta, M., Jones, P. D., and Parker D. E., 2013: HadISDH: An updated land surface\r\nspecific humidity product for climate monitoring. Climate of the Past, 9, 657-677,\r\ndoi:10.5194/cp-9-657-2013.",
    "keywords": "HadISDH, humidity, surface, land, gridded, station, specific humidity, temperature, dew point temperature, wet bulb temperature, dew point temperature, vapour pressure, in-situ",
    "publicationState": "citable",
    "dataPublishedTime": "2025-06-25T11:15:36",
    "doiPublishedTime": "2025-06-25T11:16:01.510445",
    "updateFrequency": "notPlanned",
    "status": "completed",
    "result_field": {
        "ob_id": "https://api.catalogue.ceda.ac.uk/api/v2/observations/44296/?format=api",
        "dataPath": "/badc/ukmo-hadobs/data/insitu/MOHC/HadOBS/HadISDH/mon/HadISDHTable/r1/v4-6-1-2024f",
        "oldDataPath": [],
        "storageLocation": "internal",
        "storageStatus": "online",
        "volume": 115018265,
        "numberOfFiles": 9,
        "fileFormat": "Data are NetCDF formatted"
    },
    "timePeriod": "https://api.catalogue.ceda.ac.uk/api/v2/times/12389/?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/56886/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/56887/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/56888/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/56889/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/56890/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/56891/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/56892/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/56893/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/56894/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/56895/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/56898/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/56899/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/56900/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/60438/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/66183/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/66184/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/66185/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/66187/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/66189/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/66192/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/73574/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/73575/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/73576/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/73577/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/73578/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/73579/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/73580/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/73581/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/73582/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/73583/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/73584/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/73585/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/73586/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/73587/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/73588/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/73589/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/73590/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/73591/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/73592/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/73593/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/73594/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/73595/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/73596/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/73597/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/73598/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/73599/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/76035/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/76036/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/76037/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/76038/?format=api"
    ],
    "dataLineage": "HadISDH.land is a global land surface (~2 m) humidity dataset and is produced by the Met Office Hadley Centre in collaboration with Maynooth University, NOAA National Centers for Environmental Information (NCEI), National Physical Laboratory (NPL) and Climate Research Unit (CRU). It is based on the quality controlled sub-daily HadISD from the Met Office Hadley Centre which is in turn based on the ISD dataset from NOAA's NCEI. It is passed to the Centre for Environmental Data Analysis (CEDA) for archiving and distribution.",
    "removedDataTime": null,
    "removedDataReason": "",
    "language": "English",
    "identifier_set": [
        "https://api.catalogue.ceda.ac.uk/api/v2/identifiers/13428/?format=api"
    ],
    "projects": [
        "https://api.catalogue.ceda.ac.uk/api/v2/projects/13164/?format=api"
    ],
    "observationcollection_set": [
        "https://api.catalogue.ceda.ac.uk/api/v2/observationcollections/13522/?format=api"
    ],
    "responsiblepartyinfo_set": [
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/211904/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/211898/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/211906/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/211899/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/211900/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/211901/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/211905/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/211902/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/211903/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/211908/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/211907/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/211909/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/211910/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/211911/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/211912/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/211913/?format=api"
    ],
    "procedureAcquisition": null,
    "procedureCompositeProcess": null,
    "procedureComputation": "https://api.catalogue.ceda.ac.uk/api/v2/computations/13526/?format=api",
    "permissions": [
        {
            "ob_id": "https://api.catalogue.ceda.ac.uk/api/v2/observations/2561/?format=api",
            "useLimitation": null,
            "accessConstraints": null,
            "accessCategory": "public",
            "accessRoles": null,
            "label": "public: None group",
            "licenceURL": "http://www.nationalarchives.gov.uk/doc/non-commercial-government-licence/version/2/",
            "licenceClassifications": "personal, academic, policy"
        }
    ],
    "discoveryKeywords": []
}