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

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

{
    "ob_id": 13959,
    "uuid": "8dae572c6c3747c79e2f2043c3c2f805",
    "title": "SOLAS: Leicester Spectral Radiometer species measurements at Cape Verde Observatory (2009)",
    "abstract": "Data from observations made at the The Cape Verde Atmospheric Observatory (16.848N, 24.871W) which exists to advance understanding of climatically significant interactions between the atmosphere and ocean and to provide a regional focal point and long-term data. The observatory is based on Calhau Island of São Vicente, Cape Verde in the tropical Eastern North Atlantic Ocean, a region which is data poor but plays a key role in atmosphere-ocean interactions of climate-related and biogeochemical parameters including greenhouse gases. It is an open-ocean site that is representative of a region likely to be sensitive to future climate change, and is minimally influenced by local effects and intermittent continental pollution. The dataset contains Spectral Radiometer species data during Cape Verde Solas 2009 from the University of Leicester.",
    "keywords": "SOLAS, Cape Verde, Chemistry",
    "publicationState": "published",
    "dataPublishedTime": "2010-03-30T08:00:20",
    "doiPublishedTime": null,
    "updateFrequency": "asNeeded",
    "status": "ongoing",
    "result_field": {
        "ob_id": "https://api.catalogue.ceda.ac.uk/api/v2/observations/13960/?format=api",
        "dataPath": "/badc/solas/data/capeverde/leic-sr",
        "oldDataPath": [],
        "storageLocation": "internal",
        "storageStatus": "online",
        "volume": 28904311,
        "numberOfFiles": 4,
        "fileFormat": "Data are NASA Ames formatted"
    },
    "timePeriod": "https://api.catalogue.ceda.ac.uk/api/v2/times/3732/?format=api",
    "geographicExtent": "https://api.catalogue.ceda.ac.uk/api/v2/bboxes/12/?format=api",
    "nonGeographicFlag": false,
    "phenomena": [
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/13005/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/13006/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/13007/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/13008/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/13009/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/13010/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/13011/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/13012/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/13013/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/13014/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/13015/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/13016/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/13017/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/13018/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/13019/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/13020/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/13021/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/13022/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/13023/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/13024/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/13025/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/13026/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/13027/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/13028/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/13029/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/13030/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/13031/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/13032/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/13033/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/13034/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/13035/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/13036/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/13037/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/13038/?format=api"
    ],
    "dataLineage": "Data collected at Cape Verde Atmospheric Observatory before being transmitted back to UK where NCAS staff prepare data for archiving at BADC.",
    "removedDataTime": null,
    "removedDataReason": "",
    "language": "English",
    "identifier_set": [],
    "projects": [
        "https://api.catalogue.ceda.ac.uk/api/v2/projects/5010/?format=api"
    ],
    "observationcollection_set": [
        "https://api.catalogue.ceda.ac.uk/api/v2/observationcollections/5007/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/observationcollections/872/?format=api"
    ],
    "responsiblepartyinfo_set": [
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/53583/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/53581/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/53582/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/53580/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/53584/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/53585/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/53586/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/53587/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/75356/?format=api"
    ],
    "procedureAcquisition": "https://api.catalogue.ceda.ac.uk/api/v2/acquisitions/13961/?format=api",
    "procedureCompositeProcess": null,
    "procedureComputation": null,
    "permissions": [
        {
            "ob_id": "https://api.catalogue.ceda.ac.uk/api/v2/observations/2526/?format=api",
            "useLimitation": null,
            "accessConstraints": null,
            "accessCategory": "public",
            "accessRoles": null,
            "label": "public: None group",
            "licenceURL": "http://www.nationalarchives.gov.uk/doc/open-government-licence/version/3/",
            "licenceClassifications": "any"
        }
    ],
    "discoveryKeywords": [
        {
            "ob_id": 1138,
            "name": "NDGO0003"
        }
    ]
}