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

{
    "ob_id": 13528,
    "uuid": "fd038d5dcba14f58ac2770ad47acf39c",
    "title": "HadISDH: gridded global monthly land surface humidity data version 2.0.1.2014p",
    "abstract": "This is the 2.0.1.2014p version of the HadISDH land data. The data are provided by the Met Office Hadley Centre. This version spans 1/1/1973 to 31/12/2014.\r\n\r\nMonthly gridded (5 degree by 5 degree) and station 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). Data are provided in either NetCDF or ASCII format.\r\n\r\nUncertainty estimates are provided at the station and gridbox level covering station uncertainty (climatological, homogenisation and measurement uncertainty), gridbox spatial and temporal sampling uncertainty and combined station and sampling uncertainty.\r\n\r\nTo keep up to date with 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\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\nWillett, K. M., Dunn, R. J. H., Thorne, P. W., Bell, S., de Podesta, M., Parker, D. E., Jones, P. D., and Williams Jr., C. N.: HadISDH land surface multi-variable humidity and temperature record for climate monitoring, Clim. Past, 10, 1983-2006, doi:10.5194/cp-10-1983-2014, 2014. \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\nWe strongly recommend that you read these papers before making use of the data, more detail 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 Podesta, M., Jones, P. D., and Parker D. E., 2013: HadISDH: An updated land surface specific humidity product for climate monitoring. Climate of the Past, 9, 657-677, doi:10.5194/cp-9-657-2013.",
    "keywords": "HadISDH",
    "publicationState": "published",
    "dataPublishedTime": "2016-07-28T07:14:48",
    "doiPublishedTime": null,
    "updateFrequency": "notPlanned",
    "status": "superseded",
    "result_field": {
        "ob_id": "https://api.catalogue.ceda.ac.uk/api/v2/observations/13529/?format=api",
        "dataPath": "/badc/ukmo-hadobs/data/insitu/MOHC/HadOBS/HadISDH/mon/HadISDHTable/r1/v2-0-1-2014p",
        "oldDataPath": [],
        "storageLocation": "internal",
        "storageStatus": "online",
        "volume": 614799711,
        "numberOfFiles": 29,
        "fileFormat": "These data are provided in NetCDF and ASCII format, descriptors of the file formats are included in Docs"
    },
    "timePeriod": "https://api.catalogue.ceda.ac.uk/api/v2/times/3662/?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/25173/?format=api",
        "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/56897/?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/56901/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/56902/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/56903/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/56904/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/56905/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/56909/?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/66192/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/69440/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/69441/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/69442/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/69443/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/73576/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/73580/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/73584/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/73592/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/73598/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/91280/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/91281/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/91282/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/91283/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/91284/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/91285/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/91286/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/91287/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/91288/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/91289/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/91290/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/91291/?format=api"
    ],
    "dataLineage": "HadISDH, a global land surface humidity dataset is produced by the Met Office Hadley Centre in collaboration with Maynooth University, NOAA NCEI, NPL and 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 BADC for archiving and distribution.",
    "removedDataTime": null,
    "removedDataReason": "",
    "language": "English",
    "identifier_set": [
        "https://api.catalogue.ceda.ac.uk/api/v2/identifiers/8590/?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/51680/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/51678/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/51679/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/51682/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/75085/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/75086/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/105076/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/51683/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/51681/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/168072/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/52391/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/168073/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/168074/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/52392/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/52398/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/52393/?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": [
        {
            "ob_id": 1138,
            "name": "NDGO0003"
        },
        {
            "ob_id": 1139,
            "name": "CLIPC"
        }
    ]
}