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

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

{
    "ob_id": 12435,
    "uuid": "d2adcb41c8944dc99c43e77c974c9330",
    "title": "MIPAS ENVISAT Level 1b data (July 2002 up to April 2012) IPF v5 data",
    "abstract": "Level 1b consolidated, near-real time and reprocessed data from the Michelson Interferometer for Passive Atmospheric Sounding (MIPAS) instrument on the ENVISAT satellite operated by ESA. These data are Instrument Processor Facility (IPF) version 5 data. Original release is version 5.02 with bug fixes implemented in versions 5.05 and 5.06. Improvements with respect to the previous version 4.67 data include trunctation of the interferogram at 8 cm to avoid undersampling for the Optimised Resolution (OR) mission, improved engineering heights calculation, calculation of quadratic terms for spectral calibration included in output products, and addition of L0 house keeping data packets. Data are from 1st July 2002 to 8th April 2012.",
    "keywords": "ATMOSPHERE EARTHSCIENCE SPECTRAL",
    "publicationState": "published",
    "dataPublishedTime": "2015-08-17T13:02:57",
    "doiPublishedTime": null,
    "updateFrequency": "notPlanned",
    "status": "completed",
    "result_field": {
        "ob_id": "https://api.catalogue.ceda.ac.uk/api/v2/observations/12441/?format=api",
        "dataPath": "/neodc/mipas/data/l1b/reprocessed/v5",
        "oldDataPath": [],
        "storageLocation": "internal",
        "storageStatus": "online",
        "volume": 8870286687158,
        "numberOfFiles": 71477,
        "fileFormat": "Data are binary formatted."
    },
    "timePeriod": "https://api.catalogue.ceda.ac.uk/api/v2/times/2440/?format=api",
    "geographicExtent": "https://api.catalogue.ceda.ac.uk/api/v2/bboxes/1/?format=api",
    "nonGeographicFlag": false,
    "phenomena": [
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/25878/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/26107/?format=api"
    ],
    "dataLineage": "Data acquired directly from ESA (European Space Agency) via File Transfer Protocol.",
    "removedDataTime": null,
    "removedDataReason": "",
    "language": "English",
    "identifier_set": [],
    "projects": [
        "https://api.catalogue.ceda.ac.uk/api/v2/projects/7819/?format=api"
    ],
    "observationcollection_set": [
        "https://api.catalogue.ceda.ac.uk/api/v2/observationcollections/8536/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/observationcollections/30129/?format=api"
    ],
    "responsiblepartyinfo_set": [
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/47522/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/47523/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/47521/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/47525/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/47526/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/47527/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/47528/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/47524/?format=api"
    ],
    "procedureAcquisition": "https://api.catalogue.ceda.ac.uk/api/v2/acquisitions/8542/?format=api",
    "procedureCompositeProcess": null,
    "procedureComputation": null,
    "permissions": [
        {
            "ob_id": "https://api.catalogue.ceda.ac.uk/api/v2/observations/2574/?format=api",
            "useLimitation": null,
            "accessConstraints": null,
            "accessCategory": "restricted",
            "accessRoles": "mipas",
            "label": "restricted: mipas group",
            "licenceURL": "https://artefacts.ceda.ac.uk/licences/specific_licences/mipas.pdf",
            "licenceClassifications": "unstated"
        }
    ],
    "discoveryKeywords": [
        {
            "ob_id": 1138,
            "name": "NDGO0003"
        }
    ]
}