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

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

{
    "ob_id": 13201,
    "uuid": "21b5b970a6844d72afa4b2c551944d9b",
    "title": "NOCS 2.0: National Oceanography Centre Southampton Surface Flux Climatology (version 2.0)",
    "abstract": "The National Oceanography Centre Southampton (NOCS) Version 2.0 Surface Flux Dataset is a monthly mean gridded dataset of marine surface measurements and derived fluxes constructed using optimal interpolation. Input for the period 1973 to 2006 are ICOADS Release 2.4 ship data, the update from 2007 to 2014 uses ICOADS Release 2.5 and data after 2007 are preliminary. The dataset is presented as a time series of monthly mean values on a 1 degree area grid. \r\nThe quality of the gridded data is quantified by estimates of random, bias and total uncertainty. The monthly means were derived from daily estimates of each variable and the standard deviation of these daily values is also available.  Please see nocs2_variable_defs document for detailed variable information. Users are advised to take account of the uncertainty estimates provided, and to note that in very poorly sampled regions, such as the Southern Ocean, the uncertainty estimates themselves may be unreliable.\r\n\r\nSurface meteorological fields have been adjusted to account for varying measurement heights and for known biases (Berry and Kent 2009, Berry and Kent 2011). Surface fluxes have been calculated from daily fields of the surface meteorological parameters using bulk parameterisations (Reed 1977; Clark et al. 1974; Smith 1980; 1988).\r\n\r\nThe NOCS v2.0 flux dataset was funded by the Oceans2025 project.\r\n\r\n",
    "keywords": "SOC, NOCS, NOC1.1, NOC, ocean, freshwater, winstress, heat flux, air-sea interaction",
    "publicationState": "published",
    "dataPublishedTime": "2014-09-22T03:51:07",
    "doiPublishedTime": null,
    "updateFrequency": "unknown",
    "status": "completed",
    "result_field": {
        "ob_id": "https://api.catalogue.ceda.ac.uk/api/v2/observations/13202/?format=api",
        "dataPath": "/badc/nocs_flux/data/noc2.0",
        "oldDataPath": [],
        "storageLocation": "internal",
        "storageStatus": "online",
        "volume": 9406205011,
        "numberOfFiles": 457,
        "fileFormat": "File format is COARDS compliant netCDF. "
    },
    "timePeriod": "https://api.catalogue.ceda.ac.uk/api/v2/times/3585/?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/4385/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/11990/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/11991/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/21900/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/52685/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/52686/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/52687/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/52688/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/52689/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/52690/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/52691/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/52692/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/52693/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/52694/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/52695/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/52696/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/52697/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/52698/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/52699/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/52700/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/52701/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/52702/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/52703/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/52704/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/52705/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/52706/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/52707/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/52708/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/52709/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/52710/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/52711/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/52712/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/52713/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/52714/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/52715/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/52716/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/52717/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/52718/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/52719/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/52720/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/52721/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/52722/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/52723/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/52724/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/52725/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/52726/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/52727/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/52728/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/52729/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/52730/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/52731/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/52732/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/52733/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/52734/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/52735/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/52736/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/52737/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/52738/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/52739/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/52740/?format=api"
    ],
    "dataLineage": "Data is provided by NOCS (National Oceanography Centre, Southampton) to the BADC for archiving.",
    "removedDataTime": null,
    "removedDataReason": "",
    "language": "English",
    "identifier_set": [
        "https://api.catalogue.ceda.ac.uk/api/v2/identifiers/8552/?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/5455/?format=api"
    ],
    "responsiblepartyinfo_set": [
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/50583/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/50584/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/50589/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/50591/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/50593/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/50588/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/50590/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/50595/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/50587/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/50592/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/55466/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/169575/?format=api"
    ],
    "procedureAcquisition": null,
    "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"
        }
    ]
}