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

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

{
    "ob_id": 27548,
    "uuid": "96a6ad89375a4f9ca68489758f9259da",
    "title": "Methane Observations and Yearly Assessments (MOYA): Hourly averaged methane measurements taken from Sapper Hill, Falkland Islands Atmospheric Observatory, 2010-2018",
    "abstract": "This dataset contains hourly averaged methane measurements taken from Sapper Hill, Falkland Islands Atmospheric Observatory from 2010-2018. Sapper Hill, Falkland Islands Atmospheric Observatory was established by the Royal Holloway Greenhouse Gas Research Group in October 2010 and handed to the British Antarctic Survey AIC group in September 2016 for long term observations of atmospheric mixing ratios. The observatory is located on Sapper Hill overlooking Stanley.\r\n\r\nThis data was collected as part of the Methane Observations and Yearly Assessments (MOYA) project funded by the Natural Environment Research Council (NERC) (NE/N016211/1).",
    "keywords": "MOYA, Methan, Sapper hill, Falklands, SONATA",
    "publicationState": "published",
    "dataPublishedTime": "2019-08-05T10:35:13",
    "doiPublishedTime": null,
    "updateFrequency": "notPlanned",
    "status": "completed",
    "result_field": {
        "ob_id": "https://api.catalogue.ceda.ac.uk/api/v2/observations/27549/?format=api",
        "dataPath": "/badc/moya/data/stations/sapper-hill-falkland",
        "oldDataPath": [],
        "storageLocation": "internal",
        "storageStatus": "online",
        "volume": 3565330,
        "numberOfFiles": 2,
        "fileFormat": "Data are netCDF formatted."
    },
    "timePeriod": "https://api.catalogue.ceda.ac.uk/api/v2/times/7390/?format=api",
    "geographicExtent": "https://api.catalogue.ceda.ac.uk/api/v2/bboxes/2401/?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/53935/?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/53945/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/53946/?format=api"
    ],
    "dataLineage": "Data were collected by Royal Holloway and BAS and are calibrated to the NOAA scale. Then deposited at the Centre for Environmental Data Analysis (CEDA) for archiving.",
    "removedDataTime": null,
    "removedDataReason": "",
    "language": "English",
    "identifier_set": [],
    "projects": [],
    "observationcollection_set": [
        "https://api.catalogue.ceda.ac.uk/api/v2/observationcollections/24762/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/observationcollections/27293/?format=api"
    ],
    "responsiblepartyinfo_set": [
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/115228/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/115234/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/115230/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/115231/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/115232/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/115233/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/115235/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/115229/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/168382/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/115236/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/115237/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/115238/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/115239/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/115240/?format=api"
    ],
    "procedureAcquisition": "https://api.catalogue.ceda.ac.uk/api/v2/acquisitions/27550/?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": [
        {
            "ob_id": 1138,
            "name": "NDGO0003"
        }
    ]
}