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

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

{
    "ob_id": 30132,
    "uuid": "0cb4cdde0ab6407690b2cc98dc858149",
    "title": "Microbiology-Ocean-Cloud Coupling in the High Arctic (MOCCHA): particle concentration and particle size distribution from the University of Leeds FSSP on board Icebreaker Oden",
    "abstract": "This dataset contains particle concentration and size distributions from the University of Leeds Forward Scattering Spectrometer Probe (FSSP) on board the Swedish Icebreaker Oden during the joint Arctic Climate Across Scales (ACAS) and Microbiology-Ocean-Cloud Coupling in the High Arctic (MOCCHA) projects - both part of the Arctic Ocean 2018 (AO2018) expedition to the High Arctic\r\n\r\nAO2018 took place in the Arctic from 1 August until 21 September 2018. These measurements were used to complement a suite of other observations taken during the expedition. Those of the UK contribution, as well as selected other data, are available within the associated data collection in the Centre for Environmental Data Analysis (CEDA) archives. Other cruise data may be available in the Bolin Centre for Climate Research MOCCHA/AO2018 holdings.\r\n\r\nThe UK participation of MOCCHA was funded by the Natural Environment Research Council (NERC, grant: NE/R009686/1) and involved instrumentation from the Atmospheric Measurement Facility (AMF) of the UK's National Centre for Atmospheric Science (NCAS AMF).",
    "keywords": "MOCCHA, FSSP, particle, aerosol, Arctic",
    "publicationState": "preview",
    "dataPublishedTime": null,
    "doiPublishedTime": null,
    "updateFrequency": "notPlanned",
    "status": "completed",
    "result_field": {
        "ob_id": "https://api.catalogue.ceda.ac.uk/api/v2/observations/30133/?format=api",
        "dataPath": "/badc/moccha/data/icebreaker-oden/leeds-fssp",
        "oldDataPath": [],
        "storageLocation": "internal",
        "storageStatus": "online",
        "volume": 88674987,
        "numberOfFiles": 67,
        "fileFormat": "Data are netCDF formatted."
    },
    "timePeriod": "https://api.catalogue.ceda.ac.uk/api/v2/times/8186/?format=api",
    "geographicExtent": "https://api.catalogue.ceda.ac.uk/api/v2/bboxes/2589/?format=api",
    "nonGeographicFlag": false,
    "phenomena": [
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/50512/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/53936/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/53937/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/53938/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/53939/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/53940/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/53941/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/53942/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/53943/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/53944/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/53947/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/62012/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/62013/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/62014/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/62015/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/62016/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/62017/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/62018/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/62019/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/62020/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/62021/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/62022/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/62023/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/62024/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/74110/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/91353/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/91354/?format=api"
    ],
    "dataLineage": "Data were collected, quality controlled and prepared for archiving by the MOCCHA project data authors before upload to the Centre for Environmental Data Analysis (CEDA) for long term archiving.",
    "removedDataTime": null,
    "removedDataReason": "",
    "language": "English",
    "identifier_set": [],
    "projects": [
        "https://api.catalogue.ceda.ac.uk/api/v2/projects/29975/?format=api"
    ],
    "observationcollection_set": [
        "https://api.catalogue.ceda.ac.uk/api/v2/observationcollections/29977/?format=api"
    ],
    "responsiblepartyinfo_set": [
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/130187/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/130188/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/130189/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/130190/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/130191/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/130192/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/130194/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/130193/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/168372/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/130195/?format=api"
    ],
    "procedureAcquisition": "https://api.catalogue.ceda.ac.uk/api/v2/acquisitions/30134/?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": []
}