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

{
    "ob_id": 8552,
    "uuid": "cf27c81e7f54c3701899017d1b810f81",
    "title": "UK building classes",
    "abstract": "The Building Class data provides detailed information about residential housing types including the house age and structural type. This information can be used for urban regeneration studies, crime monitoring, urban flooding and urban gardens. These data were collected by The GeoInformation Group (TGG), primarily through interpretation of high-resolution aerial photography, as part of the Cities Revealed project. The data were subsequently acquired by the Landmap project.\r\n\r\nThe 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-22T08:03:08",
    "doiPublishedTime": null,
    "updateFrequency": "notPlanned",
    "status": "completed",
    "result_field": {
        "ob_id": "https://api.catalogue.ceda.ac.uk/api/v2/observations/8553/?format=api",
        "dataPath": "/neodc/landmap/data/feature/building_class_100x100km",
        "oldDataPath": [],
        "storageLocation": "internal",
        "storageStatus": "online",
        "volume": 3240512447,
        "numberOfFiles": 4494,
        "fileFormat": "Data are available as shapefiles in 100x100km tiles. The location of the tiles can be determined by the key provided with the data. The shapefiles comprise of .shp, .shx and .dbf files.\r\n\r\nshp - shape format; the feature geometry itself\r\nshx - shape index format; a positional index of the feature geometry to allow seeking forwards and backwards quickly\r\ndbf - attribute format; columnar attributes for each shape, in dBase IV format\r\n\r\nAlso provided are prj, sbn, sbx and xml files.\r\n\r\nprj - projection format; the coordinate system and projection information, a plain text file describing the projection\r\nsbn and sbx - a spatial index of the features\r\nxml - location and other associated information\r\n\r\nFree software can be used to open shapefiles, such as Quantum GIS (QGIS) or User-friendly Desktop Internet GIS (uDig) - see links.\r\n\r\nThe classifications found in the attribute table (dbf files) of the shapefiles can be identified using this building class reference sheet (see links). 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 guide to the building class dataset (see links)."
    },
    "timePeriod": "https://api.catalogue.ceda.ac.uk/api/v2/times/3408/?format=api",
    "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/5477/?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/33840/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/33841/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/33842/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/33843/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/43894/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/33839/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/43896/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/43895/?format=api"
    ],
    "procedureAcquisition": "https://api.catalogue.ceda.ac.uk/api/v2/acquisitions/8555/?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"
        }
    ]
}