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

{
    "ob_id": 32100,
    "uuid": "f5a674c74cdd427594b6f3793b536cd0",
    "title": "HadISD: Global sub-daily, surface meteorological station data, 1931-2020, v3.1.1.2020f",
    "abstract": "This is version 3.1.1.2020f of Met Office Hadley Centre's Integrated Surface Database, HadISD. These data are global sub-daily surface meteorological data that extends HadISD v3.1.0.2019f to include 2020 and so spans 1931-2020.\r\n\r\nThe quality controlled variables in this dataset are: temperature, dewpoint temperature, sea-level pressure, wind speed and direction, cloud data (total, low, mid and high level). Past significant weather and precipitation data are also included, but have not been quality controlled, so their quality and completeness cannot be guaranteed. Quality control flags and data values which have been removed during the quality control process are provided in the qc_flags and flagged_values fields, and ancillary data files show the station listing with a station listing with IDs, names and location information. \r\n\r\nThe data are provided as one NetCDF file per station. Files in the station_data folder station data files have the format \"station_code\"_HadISD_HadOBS_19310101-20210101_v3-1-1-2020f.nc. The station codes can be found under the docs tab. The station codes file has five columns as follows: 1) station code, 2) station name 3) station latitude 4) station longitude 5) station height.\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 HadISD blog: http://hadisd.blogspot.co.uk/\r\n\r\nReferences:\r\nWhen using the dataset in a paper you must cite the following papers (see Docs for link to the publications) and this dataset (using the \"citable as\" reference) :\r\n\r\nDunn, R. J. H., (2019), HadISD version 3: monthly updates, Hadley Centre Technical Note.\r\n\r\nDunn, R. J. H., Willett, K. M., Parker, D. E., and Mitchell, L.: Expanding HadISD: quality-controlled, sub-daily station data from 1931, Geosci. Instrum. Method. Data Syst., 5, 473-491, doi:10.5194/gi-5-473-2016, 2016.\r\n\r\nDunn, R. J. H., et al. (2012), HadISD: A Quality Controlled global synoptic report database for selected variables at long-term stations from 1973-2011, Clim. Past, 8, 1649-1679, 2012, doi:10.5194/cp-8-1649-2012\r\n\r\nSmith, A., N. Lott, and R. Vose, 2011: The Integrated Surface Database: Recent Developments and Partnerships. Bulletin of the American Meteorological Society, 92, 704–708, doi:10.1175/2011BAMS3015.1\r\n\r\nFor a homogeneity assessment of HadISD please see this following reference\r\n\r\nDunn, R. J. H., K. M. Willett, C. P. Morice, and D. E. Parker. \"Pairwise homogeneity assessment of HadISD.\" Climate of the Past 10, no. 4 (2014): 1501-1522. doi:10.5194/cp-10-1501-2014, 2014.",
    "keywords": "HadISD, temperature, dewpoint, pressure, wind, speed, direction, cloud, precipitation",
    "publicationState": "published",
    "dataPublishedTime": "2021-01-27T15:15:03",
    "doiPublishedTime": null,
    "updateFrequency": "notPlanned",
    "status": "superseded",
    "result_field": {
        "ob_id": "https://api.catalogue.ceda.ac.uk/api/v2/observations/32122/?format=api",
        "dataPath": "/badc/ukmo-hadobs/data/insitu/MOHC/HadOBS/HadISD/subdaily/HadISDTable/r1/v3-1-1-2020f/",
        "oldDataPath": [],
        "storageLocation": "internal",
        "storageStatus": "online",
        "volume": 46796106598,
        "numberOfFiles": 8500,
        "fileFormat": "The data are NetCDF formatted."
    },
    "timePeriod": "https://api.catalogue.ceda.ac.uk/api/v2/times/8810/?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/54776/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/54777/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/54778/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/54779/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/54780/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/54781/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/54782/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/54783/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/54784/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/54785/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/54786/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/54787/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/54788/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/54789/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/54790/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/54791/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/54793/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/54794/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/54795/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/61314/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/62629/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/62630/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/62631/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/62633/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/62634/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/62635/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/62636/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/62637/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/82938/?format=api"
    ],
    "dataLineage": "HadISD the global sub-daily station dataset was produced by the Met Office Hadley Centre. It was derived from the Integrated Surface Dataset (ISD) from NOAA's National Climatic Data Center (NCDC). HadISD has been passed to the Centre for Environmental Data Analysis (CEDA) for archiving and distribution.",
    "removedDataTime": null,
    "removedDataReason": "",
    "language": "English",
    "identifier_set": [],
    "projects": [
        "https://api.catalogue.ceda.ac.uk/api/v2/projects/13164/?format=api"
    ],
    "observationcollection_set": [
        "https://api.catalogue.ceda.ac.uk/api/v2/observationcollections/13521/?format=api"
    ],
    "responsiblepartyinfo_set": [
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/142333/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/142336/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/142337/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/142338/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/142331/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/142332/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/142339/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/142334/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/142335/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/142341/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/148551/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/142340/?format=api"
    ],
    "procedureAcquisition": null,
    "procedureCompositeProcess": null,
    "procedureComputation": "https://api.catalogue.ceda.ac.uk/api/v2/computations/20043/?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": [
        {
            "ob_id": 1138,
            "name": "NDGO0003"
        }
    ]
}