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

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

{
    "ob_id": 12846,
    "uuid": "caf4990b34ea4bb0ad90f8246ea1bde5",
    "title": "Armagh Observatory: Soil temperature at 30cm observations from 1904-2003",
    "abstract": "Soil temperature observations from the Armagh Observatory, founded in 1790 by Archbishop Richard Robinson. As well as astronomical observations various meteorological parameters have been recorded since 1794. If users wish to find data from other areas of work undertaken by the observatory they should visit the Armagh Observatory website.",
    "keywords": "Armagh, Soil temperature",
    "publicationState": "published",
    "dataPublishedTime": "2007-03-19T16:46:20",
    "doiPublishedTime": null,
    "updateFrequency": "notPlanned",
    "status": "completed",
    "result_field": {
        "ob_id": "https://api.catalogue.ceda.ac.uk/api/v2/observations/12847/?format=api",
        "dataPath": "/badc/armagh/data/soil_temperature/soil_temp_30cm",
        "oldDataPath": [],
        "storageLocation": "internal",
        "storageStatus": "online",
        "volume": 391487,
        "numberOfFiles": 12,
        "fileFormat": "Data are stored in a bespoke ASCII format. See linked documentation for further details.\r\n"
    },
    "timePeriod": "https://api.catalogue.ceda.ac.uk/api/v2/times/3475/?format=api",
    "geographicExtent": "https://api.catalogue.ceda.ac.uk/api/v2/bboxes/36/?format=api",
    "nonGeographicFlag": false,
    "phenomena": [
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/21923/?format=api"
    ],
    "dataLineage": "Data are collected at the Armagh Observatory and obtained by the BADC for use by the research community.",
    "removedDataTime": null,
    "removedDataReason": "",
    "language": "English",
    "identifier_set": [],
    "projects": [
        "https://api.catalogue.ceda.ac.uk/api/v2/projects/2318/?format=api"
    ],
    "observationcollection_set": [
        "https://api.catalogue.ceda.ac.uk/api/v2/observationcollections/2315/?format=api"
    ],
    "responsiblepartyinfo_set": [
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/49073/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/49074/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/49072/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/49076/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/49077/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/49078/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/49079/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/49075/?format=api"
    ],
    "procedureAcquisition": "https://api.catalogue.ceda.ac.uk/api/v2/acquisitions/2321/?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"
        }
    ]
}