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

{
    "ob_id": 31987,
    "uuid": "b1bd715112ca43ab948226d11d72b85e",
    "title": "ESA Fire Climate Change Initiative (Fire_cci): AVHRR-LTDR Burned Area Pixel product, version 1.1",
    "abstract": "The ESA Fire Disturbance Climate Change Initiative (CCI) project has produced maps of global burned area derived from satellite observations. The AVHRR - LTDR Pixel v1.1 product described here contains gridded data of global burned area derived from spectral information from the AVHRR (Advanced Very High Resolution Radiometer) Land Long Term Data Record (LTDR) v5 dataset produced by NASA.\r\n\r\nThe dataset provides monthly information on global burned area at 0.05-degree spatial resolution (the resolution of the AVHRR-LTDR input data) from 1982 to 2018. The year 1994 is omitted as there was not enough input data for this year. The dataset is distributed in monthly GeoTIFF files, packed in annual tar.gz files, and it includes 5 files: date of BA detection (labelled JD), confidence label (CL), burned area in each pixel (BA), number of observations in the month (OB) and a metadata file. For further information on the product and its format see the Product User Guide.",
    "keywords": "ESA, CCI, Pixel, Burned Area, Fire Disturbance, Climate Change, GCOS Essential Climate Variable",
    "publicationState": "citable",
    "dataPublishedTime": "2020-12-21T11:28:50",
    "doiPublishedTime": "2020-12-21T11:31:56",
    "updateFrequency": "notPlanned",
    "status": "completed",
    "result_field": {
        "ob_id": "https://api.catalogue.ceda.ac.uk/api/v2/observations/32066/?format=api",
        "dataPath": "/neodc/esacci/fire/data/burned_area/AVHRR-LTDR/pixel/v1.1/",
        "oldDataPath": [],
        "storageLocation": "internal",
        "storageStatus": "online",
        "volume": 11376050840,
        "numberOfFiles": 2198,
        "fileFormat": "Data are in GeoTiff format"
    },
    "timePeriod": "https://api.catalogue.ceda.ac.uk/api/v2/times/8790/?format=api",
    "geographicExtent": "https://api.catalogue.ceda.ac.uk/api/v2/bboxes/529/?format=api",
    "nonGeographicFlag": false,
    "phenomena": [],
    "dataLineage": "Data was produced by the ESA Fire CCI team as part of the ESA Climate Change Initiative (CCI) and is being held on the CEDA (Centre for Environmental Data Analysis) archive as part of the ESA CCI Open Data Portal project.    \r\n\r\nData has been derived from spectral information from the AVHRR Land Long Term Data Record (LTDR) product version 5 dataset (https://ltdr.modaps.eosdis.nasa.gov/cgi-bin/ltdr/ltdrPage.cgi)",
    "removedDataTime": null,
    "removedDataReason": "",
    "language": "English",
    "identifier_set": [
        "https://api.catalogue.ceda.ac.uk/api/v2/identifiers/10796/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/identifiers/10799/?format=api"
    ],
    "projects": [
        "https://api.catalogue.ceda.ac.uk/api/v2/projects/13255/?format=api"
    ],
    "observationcollection_set": [
        "https://api.catalogue.ceda.ac.uk/api/v2/observationcollections/12683/?format=api"
    ],
    "responsiblepartyinfo_set": [
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/141629/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/141627/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/141628/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/141630/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/141631/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/141632/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/141633/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/141626/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/141635/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/141634/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/141636/?format=api"
    ],
    "procedureAcquisition": null,
    "procedureCompositeProcess": "https://api.catalogue.ceda.ac.uk/api/v2/composites/27395/?format=api",
    "procedureComputation": null,
    "permissions": [
        {
            "ob_id": "https://api.catalogue.ceda.ac.uk/api/v2/observations/2539/?format=api",
            "useLimitation": null,
            "accessConstraints": null,
            "accessCategory": "public",
            "accessRoles": null,
            "label": "public: None group",
            "licenceURL": "https://artefacts.ceda.ac.uk/licences/specific_licences/esacci_fire_terms_and_conditions.pdf",
            "licenceClassifications": "any"
        }
    ],
    "discoveryKeywords": [
        {
            "ob_id": 1138,
            "name": "NDGO0003"
        },
        {
            "ob_id": 1140,
            "name": "ESACCI"
        }
    ]
}