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

{
    "ob_id": 26894,
    "uuid": "7aaa582fb00246b794dc85950f1be265",
    "title": "MIDAS Open: UK hourly rainfall data, v201901",
    "abstract": "The UK hourly rainfall data contain the rainfall amount (and duration from tilting syphon gauges) during the hour (or hours) ending at the specified time. The data also contains precipitation amounts, however precipitation measured over 24 hours are not stored. Over time a range of rain gauges have been used - see the linked MIDAS User Guide for further details.\r\n\r\nThe data were collected by observation stations operated by the Met Office across the UK and transmitted within the following message types: NCM, AWSHRLY, DLY3208, SREW and SSER. The data spans from 1915 to 2017.\r\n\r\nThis dataset is part of the Midas-open dataset collection made available by the Met Office under the UK Open Government Licence, containing only UK mainland land surface observations owned or operated by Met Office. It is a subset of the fuller, restricted Met Office Integrated Data Archive System (MIDAS) Land and Marine Surface Stations dataset, also available through the Centre for Environmental Data Analysis - see the related dataset section on this record. A large proportion of the UK raingauge observing network (associated with WAHRAIN, WADRAIN and WAMRAIN for hourly, daily and monthly rainfall measurements respectively) is operated by other agencies beyond the Met Office, and are consequently currently excluded from the Midas-open dataset.",
    "keywords": "Met Office, MIDAS, UK, meteorology, rainfall, hourly",
    "publicationState": "citable",
    "dataPublishedTime": "2019-02-12T14:30:29",
    "doiPublishedTime": "2019-03-01T08:07:18",
    "updateFrequency": "notPlanned",
    "status": "superseded",
    "result_field": {
        "ob_id": "https://api.catalogue.ceda.ac.uk/api/v2/observations/26895/?format=api",
        "dataPath": "/badc/ukmo-midas-open/data/uk-hourly-rain-obs/dataset-version-201901/",
        "oldDataPath": [],
        "storageLocation": "internal",
        "storageStatus": "online",
        "volume": 4330291525,
        "numberOfFiles": 13740,
        "fileFormat": "Data are BADC-CSV formatted."
    },
    "timePeriod": "https://api.catalogue.ceda.ac.uk/api/v2/times/7299/?format=api",
    "geographicExtent": "https://api.catalogue.ceda.ac.uk/api/v2/bboxes/17/?format=api",
    "nonGeographicFlag": false,
    "phenomena": [
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/22798/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/22804/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/22805/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/22808/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/22809/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/22810/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/22811/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/22815/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/22817/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/22818/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/22819/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/22820/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/22824/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/22828/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/22830/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/22834/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/22836/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/22837/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/22840/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/22844/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/23154/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/23155/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/23156/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/23157/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/23158/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/23159/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/23160/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/23161/?format=api"
    ],
    "dataLineage": "Data collated by the Met Office and archived in the Met Office's MIDAS database. Data are extracted from a sub-set of available tables and delivered to Centre for Environmental Data Analysis (CEDA) approximately on a yearly basis.",
    "removedDataTime": null,
    "removedDataReason": "",
    "language": "English",
    "identifier_set": [
        "https://api.catalogue.ceda.ac.uk/api/v2/identifiers/10494/?format=api"
    ],
    "projects": [
        "https://api.catalogue.ceda.ac.uk/api/v2/projects/1186/?format=api"
    ],
    "observationcollection_set": [
        "https://api.catalogue.ceda.ac.uk/api/v2/observationcollections/26184/?format=api"
    ],
    "responsiblepartyinfo_set": [
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/112911/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/112917/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/112916/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/112914/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/112913/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/112912/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/112910/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/112915/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/117065/?format=api"
    ],
    "procedureAcquisition": "https://api.catalogue.ceda.ac.uk/api/v2/acquisitions/27188/?format=api",
    "procedureCompositeProcess": null,
    "procedureComputation": null,
    "permissions": [
        {
            "ob_id": "https://api.catalogue.ceda.ac.uk/api/v2/observations/2522/?format=api",
            "useLimitation": null,
            "accessConstraints": null,
            "accessCategory": "registered",
            "accessRoles": null,
            "label": "registered: None group",
            "licenceURL": "http://www.nationalarchives.gov.uk/doc/open-government-licence/version/3/",
            "licenceClassifications": "any"
        }
    ],
    "discoveryKeywords": [
        {
            "ob_id": 1138,
            "name": "NDGO0003"
        }
    ]
}