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

{
    "ob_id": 8548,
    "uuid": "e1449eac35108b49d3a0af26bb6d2060",
    "title": "UK building heights",
    "abstract": "A database of building heights for the main conurbations of the UK, acquired by the Landmap project from The GeoInformation Group's Cities Revealed project. The height information is derived principally from the Cities Revealed LiDAR or Modern aerial imagery (see linked datasets). Each building block has three values: base of building above sea level, top of the building above sea level and height of building above local ground level. Accurate to +/- 0.5m with 95% confidence limits.\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-22T07:22:46",
    "doiPublishedTime": null,
    "updateFrequency": "notPlanned",
    "status": "completed",
    "result_field": {
        "ob_id": "https://api.catalogue.ceda.ac.uk/api/v2/observations/8549/?format=api",
        "dataPath": "/neodc/landmap/data/feature/building_heights",
        "oldDataPath": [],
        "storageLocation": "internal",
        "storageStatus": "online",
        "volume": 2637781060,
        "numberOfFiles": 7910,
        "fileFormat": "Data are available as shapefiles, which 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\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 on this record."
    },
    "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/5476/?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/33832/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/33833/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/33834/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/33835/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/44098/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/33831/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/44100/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/44099/?format=api"
    ],
    "procedureAcquisition": "https://api.catalogue.ceda.ac.uk/api/v2/acquisitions/8551/?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"
        }
    ]
}