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

{
    "ob_id": 557,
    "uuid": "1a5309a9bd99d1cd56e3472209187cbd",
    "title": "SAGE III: Level 2 Cloud product data version 3, HDF-EOS formatted",
    "abstract": "Stratospheric Aerosol and Gas Experiment III (SAGE III) was an instrument on board a Meteor-3M spacecraft, launched on December 10, 2001. Routine measurement operations began in March 2002 until the SAGE III mission was terminated in March 2006. The specific measurement objectives of SAGE III provide 1 km vertical resolution profiles of: aerosols and clouds at seven wavelengths from the mid-troposphere into the stratosphere and where appropriate, the mesosphere; O3 from the mid-troposphere to 85 km; H2O from the planetary boundary layer to 50 km; NO2 from the tropopause to 45 km; NO3 from 20 to 55 km; OClO from 15 to 25 km; and, O2 from the mid-troposphere to 70 km.\r\n\r\nThis dataset contains level 2 version 3 cloud product data.",
    "keywords": "SAGE III, aerosols, clouds",
    "publicationState": "published",
    "dataPublishedTime": "2007-01-13T00:59:11",
    "doiPublishedTime": null,
    "updateFrequency": "notPlanned",
    "status": "completed",
    "result_field": {
        "ob_id": "https://api.catalogue.ceda.ac.uk/api/v2/observations/558/?format=api",
        "dataPath": "/badc/sage3/data/g3acld.003",
        "oldDataPath": [],
        "storageLocation": "internal",
        "storageStatus": "online",
        "volume": 136517872,
        "numberOfFiles": 92,
        "fileFormat": "Data are HDF-EOS formatted\r\n"
    },
    "timePeriod": "https://api.catalogue.ceda.ac.uk/api/v2/times/154/?format=api",
    "geographicExtent": "https://api.catalogue.ceda.ac.uk/api/v2/bboxes/6/?format=api",
    "nonGeographicFlag": false,
    "phenomena": [
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/21771/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/21824/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/21919/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/21962/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/22337/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/22338/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/22341/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/22343/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/25380/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/25383/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/25386/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/25388/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/25394/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/25396/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/25397/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/25403/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/25890/?format=api"
    ],
    "dataLineage": "The Stratospheric Aerosol and Gas Experiment III (SAGE III) data were downloaded from the EOS Data Gateway, Langley DAAC Data Pool and it should be noted that the version number on that system represents the Earth Science Data Type version rather than the SAGE III Data version. Accordingly, the newly-released V3 data are stored as version '002'. Data and software supplied to the BADC by NASA Langley are stored in the BADC SAGE 3 archive.",
    "removedDataTime": null,
    "removedDataReason": "",
    "language": "English",
    "identifier_set": [
        "https://api.catalogue.ceda.ac.uk/api/v2/identifiers/393/?format=api"
    ],
    "projects": [
        "https://api.catalogue.ceda.ac.uk/api/v2/projects/19678/?format=api"
    ],
    "observationcollection_set": [
        "https://api.catalogue.ceda.ac.uk/api/v2/observationcollections/556/?format=api"
    ],
    "responsiblepartyinfo_set": [
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/1589/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/1593/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/1588/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/1587/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/1590/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/1591/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/1592/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/1595/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/1594/?format=api"
    ],
    "procedureAcquisition": null,
    "procedureCompositeProcess": "https://api.catalogue.ceda.ac.uk/api/v2/composites/565/?format=api",
    "procedureComputation": null,
    "permissions": [
        {
            "ob_id": "https://api.catalogue.ceda.ac.uk/api/v2/observations/2579/?format=api",
            "useLimitation": null,
            "accessConstraints": null,
            "accessCategory": "restricted",
            "accessRoles": "sage3",
            "label": "restricted: sage3 group",
            "licenceURL": "https://artefacts.ceda.ac.uk/licences/specific_licences/sage3.pdf",
            "licenceClassifications": "unstated"
        }
    ],
    "discoveryKeywords": [
        {
            "ob_id": 1138,
            "name": "NDGO0003"
        }
    ]
}