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

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

{
    "ob_id": 33319,
    "uuid": "7bdb8604acc940f79a88433cc83904fc",
    "title": "Cape Verde Atmospheric Observatory: FLEXPART back trajectory (2007 onwards)",
    "abstract": "Ten day back trajectory calculations made using the FLEXPART model initiated from Cape Verde Atmospheric Observatory four times a day to show the origins of the air arriving at the observatory and support the analysis of the observations. The Cape Verde Atmospheric Observatory (CVAO) exists to advance understanding of climatically significant interactions between the atmosphere and ocean and to provide a regional focal point and long-term data. \r\n\r\nThe observatory is based on Calhau Island of São Vicente, Cape Verde at 16.848N, 24.871W, in the tropical Eastern North Atlantic Ocean, a region which is data poor but plays a key role in atmosphere-ocean interactions of climate-related and biogeochemical parameters including greenhouse gases. It is an open-ocean site that is representative of a region likely to be sensitive to future climate change, and is minimally influenced by local effects and intermittent continental pollution.",
    "keywords": "Cape Verde, FLEXPART, trajectories",
    "publicationState": "published",
    "dataPublishedTime": "2021-11-19T09:14:26",
    "doiPublishedTime": null,
    "updateFrequency": "asNeeded",
    "status": "ongoing",
    "result_field": {
        "ob_id": "https://api.catalogue.ceda.ac.uk/api/v2/observations/33322/?format=api",
        "dataPath": "/badc/capeverde/data/FLEXPART-back-traj/",
        "oldDataPath": [],
        "storageLocation": "internal",
        "storageStatus": "online",
        "volume": 39033382172,
        "numberOfFiles": 20169,
        "fileFormat": "NetCDF"
    },
    "timePeriod": "https://api.catalogue.ceda.ac.uk/api/v2/times/9153/?format=api",
    "geographicExtent": "https://api.catalogue.ceda.ac.uk/api/v2/bboxes/12/?format=api",
    "nonGeographicFlag": false,
    "phenomena": [
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/46689/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/46690/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/46691/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/46692/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/46693/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/46694/?format=api"
    ],
    "dataLineage": "FLEXPART model output prepared by NCAS staff  before archiving at BADC.",
    "removedDataTime": null,
    "removedDataReason": "",
    "language": "English",
    "identifier_set": [],
    "projects": [
        "https://api.catalogue.ceda.ac.uk/api/v2/projects/875/?format=api"
    ],
    "observationcollection_set": [
        "https://api.catalogue.ceda.ac.uk/api/v2/observationcollections/872/?format=api"
    ],
    "responsiblepartyinfo_set": [
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/148819/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/148826/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/148824/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/148823/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/148822/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/148820/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/148827/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/148821/?format=api"
    ],
    "procedureAcquisition": null,
    "procedureCompositeProcess": null,
    "procedureComputation": "https://api.catalogue.ceda.ac.uk/api/v2/computations/33320/?format=api",
    "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"
        }
    ]
}