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

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

{
    "ob_id": 12577,
    "uuid": "05e34382adfa46f6987aa1315f2ca7e4",
    "title": "Met Office LIDARNET Gibraltar Vaisala CL31 ceilometer cloud base and backscatter data",
    "abstract": "Cloud base and backscatter data from the Met Office's Gibraltar Cl31 ceilometer located at Gibraltar, British Overseas Territory on the south coast of Spain. The Met Office'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 Office, lidar, ceilometer, ash",
    "publicationState": "published",
    "dataPublishedTime": "2015-07-29T15:22:41",
    "doiPublishedTime": null,
    "updateFrequency": "daily",
    "status": "ongoing",
    "result_field": {
        "ob_id": "https://api.catalogue.ceda.ac.uk/api/v2/observations/12578/?format=api",
        "dataPath": "/badc/ukmo-lidarnet/data/gibraltar/vaisala-cl31",
        "oldDataPath": [],
        "storageLocation": "internal",
        "storageStatus": "online",
        "volume": 48738251920,
        "numberOfFiles": 88891,
        "fileFormat": "Data are netCDF formatted"
    },
    "timePeriod": "https://api.catalogue.ceda.ac.uk/api/v2/times/3378/?format=api",
    "geographicExtent": "https://api.catalogue.ceda.ac.uk/api/v2/bboxes/655/?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",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/53068/?format=api"
    ],
    "dataLineage": "Data were collected by the Met Office 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": [
        "https://api.catalogue.ceda.ac.uk/api/v2/identifiers/8465/?format=api"
    ],
    "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/48116/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/48114/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/48115/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/48118/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/48119/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/48120/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/48121/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/48117/?format=api"
    ],
    "procedureAcquisition": "https://api.catalogue.ceda.ac.uk/api/v2/acquisitions/12579/?format=api",
    "procedureCompositeProcess": null,
    "procedureComputation": null,
    "permissions": [
        {
            "ob_id": "https://api.catalogue.ceda.ac.uk/api/v2/observations/2532/?format=api",
            "useLimitation": null,
            "accessConstraints": null,
            "accessCategory": "restricted",
            "accessRoles": "ukmo_wx",
            "label": "restricted: ukmo_wx group",
            "licenceURL": "https://artefacts.ceda.ac.uk/licences/specific_licences/ukmo_agreement.pdf",
            "licenceClassifications": "academic"
        },
        {
            "ob_id": "https://api.catalogue.ceda.ac.uk/api/v2/observations/2533/?format=api",
            "useLimitation": null,
            "accessConstraints": null,
            "accessCategory": "restricted",
            "accessRoles": "ukmo_wx_gov",
            "label": "restricted: ukmo_wx_gov group",
            "licenceURL": "https://artefacts.ceda.ac.uk/licences/specific_licences/ukmo_agreement_gov.pdf",
            "licenceClassifications": "policy"
        }
    ],
    "discoveryKeywords": [
        {
            "ob_id": 1138,
            "name": "NDGO0003"
        }
    ]
}