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

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

{
    "ob_id": 25437,
    "uuid": "5f56428ca2674a45bbf97179d853df0e",
    "title": "Amazonica: Greenhouse gas profile measurements (CO, CO2, CH4) above the forest canopy at four sites",
    "abstract": "Profiles of greenhouse gases CO, CO2 and CH4 taken on board a small aircraft descending in a spiral from approximately 4,420m to about 300m a.s.l. (as close to the forest canopy as possible). Samples were taken by semi-automatically filling 12 (for the Tabatinga (TAB 69.7W, 6.0S), Alta Floresta (ALF 56.7W, 8.9S) and Rio Branco (RBA 67.9W, 9.3S) sites) and 17 (for the Santarem (SAN 65.0W, 2.9S) site) 0.7-litre flasks controlled from a microprocessor and contained in one suitcase. \r\n\r\nThe profiles were taken frequently throughout the measurement campaign (2010-2012) between 12:00 and 13:00 local time - at which time, the boundary layer is close to being fully developed. Once a vertical profile had been sampled (one suitcase filled) it was analysed  at the IPEN Atmospheric Chemistry Laboratory in Sao Paulo, using a replica of the NOAA/ ESRL trace gas analysis system.",
    "keywords": "Amazonica, carbon, methane, carbon dioxide Amazon, aircraft,",
    "publicationState": "published",
    "dataPublishedTime": "2016-11-29T09:57:54",
    "doiPublishedTime": null,
    "updateFrequency": "",
    "status": "completed",
    "result_field": {
        "ob_id": "https://api.catalogue.ceda.ac.uk/api/v2/observations/20099/?format=api",
        "dataPath": "/badc/amazonica/data/greenhousegases/",
        "oldDataPath": [],
        "storageLocation": "internal",
        "storageStatus": "online",
        "volume": 1082148,
        "numberOfFiles": 10,
        "fileFormat": "Data are ASCII and NASA Ames formatted"
    },
    "timePeriod": "https://api.catalogue.ceda.ac.uk/api/v2/times/6883/?format=api",
    "geographicExtent": "https://api.catalogue.ceda.ac.uk/api/v2/bboxes/1652/?format=api",
    "nonGeographicFlag": false,
    "phenomena": [
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/2731/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/25856/?format=api"
    ],
    "dataLineage": "Data were collected by the AMAZONICA team and analysed at the IPEN Atmospheric Chemistry Laboratory in Sao Paulo, Brazil, using a replica of the NOAA/ ESRL trace gas analysis system; then deposited at BADC.",
    "removedDataTime": null,
    "removedDataReason": "",
    "language": "English",
    "identifier_set": [
        "https://api.catalogue.ceda.ac.uk/api/v2/identifiers/9363/?format=api"
    ],
    "projects": [
        "https://api.catalogue.ceda.ac.uk/api/v2/projects/2909/?format=api"
    ],
    "observationcollection_set": [
        "https://api.catalogue.ceda.ac.uk/api/v2/observationcollections/2906/?format=api"
    ],
    "responsiblepartyinfo_set": [
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/105704/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/105702/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/105703/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/105705/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/105706/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/105707/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/105710/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/105701/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/105708/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/105709/?format=api"
    ],
    "procedureAcquisition": "https://api.catalogue.ceda.ac.uk/api/v2/acquisitions/24971/?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"
        }
    ]
}