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

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

{
    "ob_id": 24961,
    "uuid": "d73b6fb4fcfa4dfd844227c5b9475a94",
    "title": "Met Éireann LIDARNET Knock Airport Vaisala CL31 ceilometer cloud base and backscatter data",
    "abstract": "Cloud base and backscatter data from the Met Éireann's Knock Airport Cl31 ceilometer located at Knock Airport, Charlestown, County Mayo, northwest Ireland. The Met Éireann's laser cloud base recorders network (LCBRs), or ceilometers, returns a range of products for use in forecasting and hazard detection. The backscatter profiles can allow detection of aerosol species such as volcanic ash where suitable instrumentation is deployed.\r\n",
    "keywords": "Met Éireann, lidar, ceilometer, ash",
    "publicationState": "published",
    "dataPublishedTime": "2017-08-25T13:05:36",
    "doiPublishedTime": null,
    "updateFrequency": "daily",
    "status": "ongoing",
    "result_field": {
        "ob_id": "https://api.catalogue.ceda.ac.uk/api/v2/observations/24962/?format=api",
        "dataPath": "/badc/ukmo-lidarnet/data/knock/vaisala-cl31/",
        "oldDataPath": [],
        "storageLocation": "internal",
        "storageStatus": "online",
        "volume": 74287122935,
        "numberOfFiles": 67921,
        "fileFormat": "Data are NetCDF formatted"
    },
    "timePeriod": "https://api.catalogue.ceda.ac.uk/api/v2/times/6752/?format=api",
    "geographicExtent": "https://api.catalogue.ceda.ac.uk/api/v2/bboxes/1853/?format=api",
    "nonGeographicFlag": false,
    "phenomena": [
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/50542/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/50543/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/53050/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/53051/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/53052/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/53053/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/53054/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/53055/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/53056/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/53057/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/53058/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/53059/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/53060/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/53061/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/53062/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/53063/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/53064/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/53065/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/53066/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/53067/?format=api"
    ],
    "dataLineage": "Data were collected by the Met Éireann before processed through the Met Office's Hermes system. A copy of these data were then delivered by the Met Office to CEDA for archiving.",
    "removedDataTime": null,
    "removedDataReason": "",
    "language": "English",
    "identifier_set": [],
    "projects": [
        "https://api.catalogue.ceda.ac.uk/api/v2/projects/12429/?format=api"
    ],
    "observationcollection_set": [
        "https://api.catalogue.ceda.ac.uk/api/v2/observationcollections/10994/?format=api"
    ],
    "responsiblepartyinfo_set": [
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/102207/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/102208/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/102209/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/102211/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/102212/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/102213/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/102214/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/102210/?format=api"
    ],
    "procedureAcquisition": "https://api.catalogue.ceda.ac.uk/api/v2/acquisitions/24963/?format=api",
    "procedureCompositeProcess": null,
    "procedureComputation": null,
    "permissions": [
        {
            "ob_id": "https://api.catalogue.ceda.ac.uk/api/v2/observations/2546/?format=api",
            "useLimitation": null,
            "accessConstraints": null,
            "accessCategory": "registered",
            "accessRoles": null,
            "label": "registered: None group",
            "licenceURL": "http://creativecommons.org/licenses/by/4.0/",
            "licenceClassifications": "any"
        }
    ],
    "discoveryKeywords": [
        {
            "ob_id": 1138,
            "name": "NDGO0003"
        }
    ]
}