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

{
    "ob_id": 8556,
    "uuid": "a65271e219166c827c1724d96172c014",
    "title": "UK building blocks",
    "abstract": "This dataset is a combination of the The GeoInformation Groups' Cities Revealed UK building heights and UK individual building classes datasets, although height information is lacking for some buildings, so users may wish to check the UK building heights database in these cases. This dataset provides outlines of building blocks with height information derived from the Cities Revealed LiDAR surveys, high-resolution aerial photography and other height data sources combined with Building Class data. The data were acquired by the Landmap project from The GeoInformation Group (TGG). 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, part of which was buildings data. 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: Cities Revealed © The GeoInformation Group yyyy",
    "keywords": "",
    "publicationState": "published",
    "dataPublishedTime": "2014-08-22T09:36:31",
    "doiPublishedTime": null,
    "updateFrequency": "notPlanned",
    "status": "completed",
    "result_field": {
        "ob_id": "https://api.catalogue.ceda.ac.uk/api/v2/observations/8557/?format=api",
        "dataPath": "/neodc/landmap/data/feature/building_blocks",
        "oldDataPath": [],
        "storageLocation": "internal",
        "storageStatus": "online",
        "volume": 1855396114,
        "numberOfFiles": 952,
        "fileFormat": "&lt;div property=\"cedacat:formats\"&gt;\r\n\r\nData are available as shapefiles, which comprise of .shp, .shx and .dbf files. \r\n&lt;ul&gt;\r\n&lt;li&gt;shp - shape format; the feature geometry itself&lt;/li&gt;\r\n&lt;li&gt;shx - shape index format; a positional index of the feature geometry to allow seeking forwards and backwards quickly&lt;/li&gt;\r\n&lt;li&gt;dbf - attribute format; columnar attributes for each shape, in dBase IV format&lt;/li&gt;\r\n&lt;/ul&gt;\r\nAlso provided are prj, sbn, sbx and xml files.\r\n&lt;ul&gt;\r\n&lt;li&gt;prj - projection format; the coordinate system and projection information, a plain text file describing the projection&lt;/li&gt;\r\n&lt;li&gt;sbn and sbx - a spatial index of the features&lt;/li&gt;\r\n&lt;li&gt;xml - location and other associated information&lt;/li&gt;\r\n&lt;/ul&gt;\r\nFree software can be used to open shapefiles, such as &lt;a href=\"http://www.qgis.org/en/site/\"&gt;Quantum GIS (QGIS)&lt;/a&gt; or &lt;a href=\"http://udig.refractions.net/\"&gt;User-friendly Desktop Internet GIS (uDig)&lt;/a&gt;.&lt;p&gt;\r\n&lt;/p&gt;\r\nThe classifications attributes found in the attribute table (dbf files) of the shapefiles can be identified using this &lt;a href=\"http://www.geoinformationgroup.co.uk/wp-content/uploads/2011/05/Building-Class-Reference-Sheet-V4-May-11.pdf\"&gt;building class reference sheet&lt;/a&gt;. There are 9 Age categories and 19 Type categories. Not all the Age/Type combinations are used, for example there are no Early and Middle Victorian very tall flats (point blocks) in the current edition of the classification (Version 6 September 2012). The current database for the UK does not contain Age categories 1 and 2 and only one type for Age 8. Also the type categories of Medium Height flats 5-6 storeys (3), Tall Terraces 3-4 storeys (5) and Very Large Detached Houses, Sometimes converted to flats (15) have been removed. These are all indicated by the DNU label in the classification sheet. More information can be found on in the The GeoInformation Group &lt;a href=\"http://badc.nerc.ac.uk/browse/neodc/landmap/documents/Building_Class_Notes_2012.pdf\"&gt;guide to the building class dataset (link here)&lt;/a&gt;. All building blocks have also have a height attribute, HGT, this value is the height of the building blocks from the base to the top of the building. In some cases this information is not supplied and presented as 0.&lt;/p&gt;\r\n&lt;/div&gt;\r\n\r\n\r\n"
    },
    "timePeriod": null,
    "geographicExtent": "https://api.catalogue.ceda.ac.uk/api/v2/bboxes/194/?format=api",
    "nonGeographicFlag": false,
    "phenomena": [],
    "dataLineage": "Data collected and prepared by the Landmap team before a copy of the data was obtained by NEODC directly from Landmap.",
    "removedDataTime": null,
    "removedDataReason": "",
    "language": "English",
    "identifier_set": [
        "https://api.catalogue.ceda.ac.uk/api/v2/identifiers/5478/?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/8547/?format=api"
    ],
    "responsiblepartyinfo_set": [
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/33848/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/33849/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/33850/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/33851/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/43177/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/33847/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/43179/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/43178/?format=api"
    ],
    "procedureAcquisition": "https://api.catalogue.ceda.ac.uk/api/v2/acquisitions/8559/?format=api",
    "procedureCompositeProcess": null,
    "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"
        }
    ]
}