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/8189/?format=api
HTTP 200 OK
Allow: GET, HEAD, OPTIONS
Content-Type: application/json
Vary: Accept

{
    "ob_id": 8189,
    "uuid": "86a063c7f894cd9eceb6e542888a13ea",
    "title": "ENVISAT Advanced Synthetic Aperture Radar (ASAR) UK imagery",
    "abstract": "Data from the Advanced Synthetic Aperture Radar (ASAR) on-board ENVISAT are available for the UK from 2002-2009. The raw data for the alternating polarisation, wide swath and image modes were acquired by the Landmap project from ESA and processed to produce 8 and 32-bit greyscale and multi-difference colour composite geotiff images. The Joint Information Systems Committee (JISC) funded Landmap service which ran from 2001 to July 2014 collected and hosted a large amount of earth observation data for the majority of the UK. After removal of JISC funding in 2013, the Landmap service is no longer operational, with the data now held at the NEODC.\r\n\r\nWhen using these data please also add the following copyright statement: © ESA 2004/2005/2006/2007/2008…. Received and Distributed by University of Manchester under licence from the European Space Agency",
    "keywords": "",
    "publicationState": "published",
    "dataPublishedTime": "2014-08-18T08:16:07",
    "doiPublishedTime": null,
    "updateFrequency": "notPlanned",
    "status": "completed",
    "result_field": {
        "ob_id": "https://api.catalogue.ceda.ac.uk/api/v2/observations/8190/?format=api",
        "dataPath": "/neodc/landmap/data/radar/asar",
        "oldDataPath": [],
        "storageLocation": "internal",
        "storageStatus": "online",
        "volume": 284111326904,
        "numberOfFiles": 4808,
        "fileFormat": "&lt;div property=\"cedacat:formats\"&gt;\n&lt;div class=\"formats\"&gt;Data availability and file format&lt;/div&gt;\n&lt;p&gt;The data are available in geotiff format which can be opened in many earth observation image processing software including open/free software such as &lt;a href=\"http://www.hexagongeospatial.com/products/ERDASERViewer/Details.aspx\"&gt;Erdas ER viewer&lt;/a&gt; and the freely available &lt;a href=\"http://www.brockmann-consult.de/cms/web/beam/\"&gt;Basic ERS &amp;amp; Envisat (A)ATSR and Meris Toolbox (BEAM)&lt;/a&gt; or &lt;a href=\"https://earth.esa.int/web/guest/software-tools/-/article/nest-next-esa-sar-toolbox-5943\"&gt;NEST (Next ESA SAR Toolbox)&lt;/a&gt;. Geotiff files are TIFF files which have geographic metadata embedded as tags within the TIFF file. The geographic metadata can then be used to position the image in the correct location and geometry on the screen of a geographic information display. The data are split into the three modes acquired by Landmap (alternating polarisation, wide swath and image modes). The various polarisations can be determined from the filename: \n&lt;/p&gt;&lt;ul&gt;\n&lt;li&gt;&lt;b&gt;hh&lt;/b&gt; - Horizontal polarisation transmitted, horizontal received. &lt;/li&gt;\n&lt;li&gt;&lt;b&gt;vv&lt;/b&gt; - Vertical transmitted, vertical received&lt;/li&gt;\n&lt;li&gt;&lt;b&gt;hv&lt;/b&gt; - Horizontal transmitted, vertical received&lt;/li&gt;\n&lt;li&gt;&lt;b&gt;vh&lt;/b&gt; - Vertical transmitted, horizontal received&lt;/li&gt;\n&lt;/ul&gt;\nSpecific products include 32 bit _geo GeoTiff, and 8 bit _geo_lia and _geo_ls_mask GeoTiffs. All the geotiff images are provided with GeoTiff World Files (.tfw) which are used to geo-reference images to an appropriate projection scheme. \n&lt;p /&gt;\n&lt;/div&gt;\n\n\n"
    },
    "timePeriod": "https://api.catalogue.ceda.ac.uk/api/v2/times/2346/?format=api",
    "geographicExtent": "https://api.catalogue.ceda.ac.uk/api/v2/bboxes/180/?format=api",
    "nonGeographicFlag": false,
    "phenomena": [],
    "dataLineage": "Data collected and prepared by the Landmap team before a copy of the data were obtained by NEODC directly from Landmap.",
    "removedDataTime": null,
    "removedDataReason": "",
    "language": "English",
    "identifier_set": [
        "https://api.catalogue.ceda.ac.uk/api/v2/identifiers/5282/?format=api"
    ],
    "projects": [
        "https://api.catalogue.ceda.ac.uk/api/v2/projects/8044/?format=api"
    ],
    "observationcollection_set": [
        "https://api.catalogue.ceda.ac.uk/api/v2/observationcollections/8181/?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/33114/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/33115/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/33116/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/33117/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/42795/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/33113/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/42797/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/42796/?format=api"
    ],
    "procedureAcquisition": null,
    "procedureCompositeProcess": "https://api.catalogue.ceda.ac.uk/api/v2/composites/8193/?format=api",
    "procedureComputation": null,
    "permissions": [
        {
            "ob_id": "https://api.catalogue.ceda.ac.uk/api/v2/observations/2588/?format=api",
            "useLimitation": null,
            "accessConstraints": null,
            "accessCategory": "restricted",
            "accessRoles": "landmap",
            "label": "restricted: landmap group",
            "licenceURL": "https://artefacts.ceda.ac.uk/licences/specific_licences/landmap.pdf",
            "licenceClassifications": "academic, specific"
        }
    ],
    "discoveryKeywords": [
        {
            "ob_id": 1138,
            "name": "NDGO0003"
        }
    ]
}