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

{
    "ob_id": 13162,
    "uuid": "6d39f49d9ce24836b16cf6ecad1f8ae6",
    "title": "NOC 1.1a: Adjusted National Oceanography Centre Surface Flux Climatology (version 1.1a)",
    "abstract": "This dataset contains the adjusted climatological monthly mean files of air-sea fluxes (heat fluxes only) on a global grid in netCDF format produced at the National Oceanography Centre (NOC). \r\n\r\nIt was produced by the NERC COAPEC thematic programme project using inverse analysis techniques to remove the global ocean heat budget imbalance of 30 Wm-2 that was present in the NOC1.1 flux climatology.\r\n\r\nEach data file contains 12 climatological monthly means on a global 1 x 1 grid for a particular flux field:\r\n\r\nlatent heat flux (hfls), \r\nnet heat flux (hfns), \r\nsensible heat flux (hfss), \r\nnet longwave flux (rls), \r\nnet shortwave flux (rss).\r\n\r\nUnits are W/m2.\r\n\r\nThe flux fields were originally derived from the COADS1a (1980-93) dataset enhanced with additional metadata from the WMO47 list of ships. A full description of the fields is given in The Southampton Oceanography Centre (SOC) Ocean - Atmosphere, Heat, Momentum and Freshwater Flux Atlas (see link under Docs) and a parallel journal paper (Josey et al, 1999) describes the results of various evaluation studies (see links under Docs).\r\n\r\nIt is important to note that the quality of the fields has a strong spatial dependence which reflects the global distribution of ship observations. Quality is likely to be high in the well sampled North Atlantic & North Pacific but to decrease in the Southern Hemisphere. In particular, south of 40 S the errors in the fields are likely to be large and we recognise the existence of spurious features which have been generated during the objective analysis of the original raw fields. NOC stress that caution must be taken when interpreting the fields in this region.\r\n",
    "keywords": "SOC, NOCS, NOC1.1a, NOC, ocean, heat flux, air-sea interaction",
    "publicationState": "published",
    "dataPublishedTime": "2014-09-22T03:50:40",
    "doiPublishedTime": null,
    "updateFrequency": "notPlanned",
    "status": "completed",
    "result_field": {
        "ob_id": "https://api.catalogue.ceda.ac.uk/api/v2/observations/13163/?format=api",
        "dataPath": "/badc/nocs_flux/data/noc1.1a",
        "oldDataPath": [],
        "storageLocation": "internal",
        "storageStatus": "online",
        "volume": 9478352,
        "numberOfFiles": 8,
        "fileFormat": "File format is COARDS compliant netCDF. Files are compressed (.Z)."
    },
    "timePeriod": "https://api.catalogue.ceda.ac.uk/api/v2/times/3584/?format=api",
    "geographicExtent": "https://api.catalogue.ceda.ac.uk/api/v2/bboxes/1/?format=api",
    "nonGeographicFlag": false,
    "phenomena": [
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/21888/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/21892/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/21900/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/25891/?format=api"
    ],
    "dataLineage": "Data is provided by NOCS (National Oceanography Centre, Southampton) to the BADC for archiving.",
    "removedDataTime": null,
    "removedDataReason": "",
    "language": "English",
    "identifier_set": [
        "https://api.catalogue.ceda.ac.uk/api/v2/identifiers/8550/?format=api"
    ],
    "projects": [
        "https://api.catalogue.ceda.ac.uk/api/v2/projects/5441/?format=api"
    ],
    "observationcollection_set": [
        "https://api.catalogue.ceda.ac.uk/api/v2/observationcollections/5455/?format=api"
    ],
    "responsiblepartyinfo_set": [
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/50457/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/50454/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/50458/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/50459/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/50460/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/50455/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/50462/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/50456/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/50461/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/55465/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/169574/?format=api"
    ],
    "procedureAcquisition": null,
    "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"
        }
    ]
}