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

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

{
    "ob_id": 27102,
    "uuid": "8692c9ac8d0d4605858c1edb7ee5da17",
    "title": "Saturation vapour pressures of atmospherically relevant organic compounds",
    "abstract": "This dataset contains values of saturation vapour pressures of atmospherically relevant organic compounds, derived from the University of Manchester Knudsend Effusion Mass Spectrometer (KEMS). This dataset was collected as part of the International network for coordinating work on the physicochemical properties of molecules and mixtures important for atmospheric particulate matter project, funded by the Natural Environment Research Council (NERC, grant: NE/N013794/1).",
    "keywords": "Vapour pressures, organic compounds, KEMS, NERC, NE/N013794/1",
    "publicationState": "published",
    "dataPublishedTime": "2019-02-14T10:36:56",
    "doiPublishedTime": null,
    "updateFrequency": "notPlanned",
    "status": "completed",
    "result_field": {
        "ob_id": "https://api.catalogue.ceda.ac.uk/api/v2/observations/27103/?format=api",
        "dataPath": "/badc/deposited2019/kems-vapour-pressure",
        "oldDataPath": [],
        "storageLocation": "internal",
        "storageStatus": "online",
        "volume": 17403,
        "numberOfFiles": 2,
        "fileFormat": "Data are BADC-CSV formatted."
    },
    "timePeriod": null,
    "geographicExtent": null,
    "nonGeographicFlag": true,
    "phenomena": [
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/59100/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/59101/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/59102/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/59103/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/59104/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/59105/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/59106/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/59107/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/59108/?format=api"
    ],
    "dataLineage": "Data were collected, quality controlled and prepared for archiving by the instrument scientist Dr Thomas Bannan 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/24873/?format=api"
    ],
    "observationcollection_set": [],
    "responsiblepartyinfo_set": [
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/113549/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/113544/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/113546/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/113547/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/113548/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/113550/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/113552/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/129600/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/113543/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/113545/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/113551/?format=api"
    ],
    "procedureAcquisition": "https://api.catalogue.ceda.ac.uk/api/v2/acquisitions/27106/?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"
        }
    ]
}