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

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

{
    "ob_id": 7801,
    "uuid": "becade1abe4abbd8135bf9b938968cc1",
    "title": "European Remote Sensing Satellite 1 (ERS-1): Synthetic Aperture Radar (SAR) data",
    "abstract": "The European Space Agency's Synthetic Aperture Radar (SAR) instruments have been flown on board ERS-1, ERS-2 and the Advanced SAR (ASAR) on board Envisat. The ERS-1, ERS-2 and Envisat satellites, launched in 1991, 1995 and 2002 respectively, are ESA multi-payload, Earth observation satellites.\r\n\r\nThis dataset contains Synthetic Aperture Radar(SAR) data from the European Remote Sensing satellites ERS-1.  \r\n\r\nThe ERS-1 mission began in 1991 and ended in 2000, and ERS-2 and Envisat are still ongoing.  SAR provides high resolution images, ocean wave spectra data and wind direction vector data.  They are available through the NEODC to UK based students only.",
    "keywords": "ESA, SAR, satellite",
    "publicationState": "published",
    "dataPublishedTime": "2007-08-09T13:45:41",
    "doiPublishedTime": null,
    "updateFrequency": "unknown",
    "status": "completed",
    "result_field": {
        "ob_id": "https://api.catalogue.ceda.ac.uk/api/v2/observations/7802/?format=api",
        "dataPath": "/neodc/esasar/ers_sar/ER1/",
        "oldDataPath": [],
        "storageLocation": "internal",
        "storageStatus": "online",
        "volume": 6140099205,
        "numberOfFiles": 65,
        "fileFormat": "Data are tar formatted"
    },
    "timePeriod": "https://api.catalogue.ceda.ac.uk/api/v2/times/2243/?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/22848/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/25947/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/25995/?format=api"
    ],
    "dataLineage": "Data collected and prepared by ESA before a copy was obtained directly from ESA by NEODC for use by UK student community",
    "removedDataTime": null,
    "removedDataReason": "",
    "language": "English",
    "identifier_set": [
        "https://api.catalogue.ceda.ac.uk/api/v2/identifiers/5062/?format=api"
    ],
    "projects": [
        "https://api.catalogue.ceda.ac.uk/api/v2/projects/7803/?format=api"
    ],
    "observationcollection_set": [
        "https://api.catalogue.ceda.ac.uk/api/v2/observationcollections/7800/?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/32287/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/32292/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/32286/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/32289/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/32290/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/32291/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/32293/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/32288/?format=api"
    ],
    "procedureAcquisition": null,
    "procedureCompositeProcess": "https://api.catalogue.ceda.ac.uk/api/v2/composites/7809/?format=api",
    "procedureComputation": null,
    "permissions": [
        {
            "ob_id": "https://api.catalogue.ceda.ac.uk/api/v2/observations/2537/?format=api",
            "useLimitation": null,
            "accessConstraints": null,
            "accessCategory": "restricted",
            "accessRoles": "esasar",
            "label": "restricted: esasar group",
            "licenceURL": "https://artefacts.ceda.ac.uk/licences/specific_licences/esasar.pdf",
            "licenceClassifications": "academic, specific"
        }
    ],
    "discoveryKeywords": [
        {
            "ob_id": 1138,
            "name": "NDGO0003"
        }
    ]
}