Observation Instance – Django REST framework

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/6670/?format=api

HTTP 200 OK
Allow: GET, HEAD, OPTIONS
Content-Type: application/json
Vary: Accept

{
    "ob_id": 6670,
    "uuid": "c9dd2107e0b7e8c7b6aca7c34980f679",
    "title": "CRU TS3.00: Climatic Research Unit (CRU) Time-Series (TS) Version 3.00 of High Resolution Gridded Data of Month-by-month Variation in Climate (Jan. 1901 - Dec.2006)",
    "abstract": "The gridded CRU TS (time-series) 3.00 data are month-by-month variations in climate over the period 1901-2006, on high-resolution (0.5x0.5 degree) grids, produced by the Climatic Research Unit (CRU) at the University of East Anglia. \r\n\r\nThe CRU TS 3.00 variables include cloud cover, diurnal temperature range, frost day frequency, precipitation, daily mean temperature, monthly average daily maximum/min temperature, vapour pressure and wet day frequency.\r\n\r\nThe BADC holds the preliminary CRU TS3.00 datasets for the period 1901-2006. Note that these data are yearly files REGARDLESS of whether the data exists for the full year. In CRU TS3.00, the data up to 06/2006 *ONLY* has been used.\r\n\r\nThe CRU TS 3.00 data are monthly gridded fields based on monthly observational data, which are calculated from daily or sub-daily data by National Meteorological Services and other external agents. The ASCII and netcdf data files both contain monthly mean values for the various parameters. \r\n\r\nAll CRU TS output files are actual values - NOT anomalies. \r\n\r\nCRU TS data are available for download to all CEDA users.",
    "keywords": "CRU TS, ATMOSPHERE, EARTHSCIENCE",
    "publicationState": "published",
    "dataPublishedTime": "2013-10-22T16:03:20",
    "doiPublishedTime": null,
    "updateFrequency": "notPlanned",
    "status": "completed",
    "result_field": {
        "ob_id": "https://api.catalogue.ceda.ac.uk/api/v2/observations/6671/?format=api",
        "dataPath": "/badc/cru/data/cru_ts/cru_ts_3.00",
        "oldDataPath": [],
        "storageLocation": "internal",
        "storageStatus": "online",
        "volume": 2878738610,
        "numberOfFiles": 36,
        "fileFormat": "The CRU TS 3.00 data (i.e. climate variables) are available in both compressed (.gz extension) ASCII \".dat\" and netcdf \".nc\" file formats. CRU TS 3.00 metadata files (i.e. stations) are available in ASCII. To understand how to read the CRU TS 3.00 data and metadata files, please refer to the CRU_TS_3.00_File_Formats_explained PDF documentation (under Linked Documentation below).\r\n\r\n"
    },
    "timePeriod": "https://api.catalogue.ceda.ac.uk/api/v2/times/1954/?format=api",
    "geographicExtent": "https://api.catalogue.ceda.ac.uk/api/v2/bboxes/513/?format=api",
    "nonGeographicFlag": false,
    "phenomena": [
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/21919/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/21935/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/21948/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/21962/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/21974/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/21978/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/25388/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/25397/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/25845/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/25879/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/25882/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/25911/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/25957/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/25978/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/25979/?format=api"
    ],
    "dataLineage": "CRU TS 3.00 data files acquired directly from CRU in 2007. CRU provided the BADC with software to generate the CRU datasets in 2010, and this was used to produce CRU TS 3.10 at the BADC in early 2011.",
    "removedDataTime": null,
    "removedDataReason": "",
    "language": "English",
    "identifier_set": [
        "https://api.catalogue.ceda.ac.uk/api/v2/identifiers/4371/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/identifiers/8335/?format=api"
    ],
    "projects": [
        "https://api.catalogue.ceda.ac.uk/api/v2/projects/6672/?format=api"
    ],
    "observationcollection_set": [
        "https://api.catalogue.ceda.ac.uk/api/v2/observationcollections/6669/?format=api"
    ],
    "responsiblepartyinfo_set": [
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/28699/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/28701/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/28702/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/28703/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/28705/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/43759/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/43763/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/28700/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/46253/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/46237/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/79198/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/43761/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/168534/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/168535/?format=api"
    ],
    "procedureAcquisition": null,
    "procedureCompositeProcess": null,
    "procedureComputation": "https://api.catalogue.ceda.ac.uk/api/v2/computations/6673/?format=api",
    "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"
        }
    ]
}