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

{
    "ob_id": 25865,
    "uuid": "a2e82c7f92dc4f389a7fb7e4e6629c9e",
    "title": "Kruger National Park Rivers LiDAR data (May 2012)",
    "abstract": "This dataset contains LiDAR and aerial photograph data for the Sabie, Olifants and Letaba rivers in the Kruger National Park, South Africa. The LiDAR and aerial photograph data were collected for the NERC funded project (NE/K001132/1) 'Evaluating and modelling the impact of extreme events on South African dryland rivers: Cyclone Dando (January 2012)'.\r\n\r\nSouthern Mapping Geospatial were commissioned in South Africa to undertake the LiDAR flights for the NERC-funded project. Processed data of point cloud, processed contours, and aerial image files were provided. Data were retrieved using an Optech Orion M200 LiDAR which scanned the ground at 70 kHz, and a Rollei AIC with 60 megapixel P65+ and Phase One digital CCD, flown at 1100m from a Cessna 206. The survey concentrated on three 50 km reaches of the Olifants, Sabie and Letaba rivers surveyed on 30th May 2012, nearly 5 months after a large Cyclone driven flood in January 2012. \r\n\r\nThe folders include:\r\n   1) Index - contains a .dgn file to position data in ArcMap, \r\n   2) Points - contains sub-folders with the raw LiDAR point cloud data; ground points and vegetation at different heights indicated by the folder label \r\n   3) Report - summary report provided by Southern mapping who we commissioned to fly the LiDAR\r\n   4) Contour data in dgn and dwg format, \r\n   5) Image tiles\r\n",
    "keywords": "LiDAR, aerial photographs, Kruger National Park, Dryland river, point cloud data, Sabie river, Olifants river, Letaba river, survey data",
    "publicationState": "published",
    "dataPublishedTime": "2018-03-16T10:38:35",
    "doiPublishedTime": null,
    "updateFrequency": "notPlanned",
    "status": "completed",
    "result_field": {
        "ob_id": "https://api.catalogue.ceda.ac.uk/api/v2/observations/25885/?format=api",
        "dataPath": "/badc/deposited2018/cyclone-dando_lidar/data",
        "oldDataPath": [],
        "storageLocation": "internal",
        "storageStatus": "online",
        "volume": 12412327041,
        "numberOfFiles": 4537,
        "fileFormat": "Contours (dgn, dwg), Images (ecw), point cloud (txt)"
    },
    "timePeriod": "https://api.catalogue.ceda.ac.uk/api/v2/times/6989/?format=api",
    "geographicExtent": "https://api.catalogue.ceda.ac.uk/api/v2/bboxes/2186/?format=api",
    "nonGeographicFlag": false,
    "phenomena": [],
    "dataLineage": "Data was prepared and sent to Centre for Environmental Data Analysis (CEDA) for archiving by the project team.",
    "removedDataTime": null,
    "removedDataReason": "",
    "language": "English",
    "identifier_set": [],
    "projects": [
        "https://api.catalogue.ceda.ac.uk/api/v2/projects/25858/?format=api"
    ],
    "observationcollection_set": [],
    "responsiblepartyinfo_set": [
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/108009/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/108010/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/108017/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/108019/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/108018/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/108016/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/108013/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/108014/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/108015/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/108011/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/108020/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/168818/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/108012/?format=api"
    ],
    "procedureAcquisition": "https://api.catalogue.ceda.ac.uk/api/v2/acquisitions/25877/?format=api",
    "procedureCompositeProcess": null,
    "procedureComputation": null,
    "permissions": [
        {
            "ob_id": "https://api.catalogue.ceda.ac.uk/api/v2/observations/2522/?format=api",
            "useLimitation": null,
            "accessConstraints": null,
            "accessCategory": "registered",
            "accessRoles": null,
            "label": "registered: None group",
            "licenceURL": "http://www.nationalarchives.gov.uk/doc/open-government-licence/version/3/",
            "licenceClassifications": "any"
        }
    ],
    "discoveryKeywords": [
        {
            "ob_id": 1138,
            "name": "NDGO0003"
        }
    ]
}