Observation Instance – Django REST framework

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/30641/?format=api

HTTP 200 OK
Allow: GET, HEAD, OPTIONS
Content-Type: application/json
Vary: Accept

{
    "ob_id": 30641,
    "uuid": "37e8a29d208d4a87ae4dbe1d16b2c0ef",
    "title": "ESA Ocean Colour Climate Change Initiative (Ocean_Colour_cci): Monthly climatology of global ocean colour data products, Version 4.2",
    "abstract": "The ESA Ocean Colour CCI project has produced global level 3 binned multi-sensor time-series of satellite ocean-colour data with a particular focus for use in climate studies.\r\n\r\nThis dataset contains a monthly climatology of the generated ocean colour products.\r\n\r\nData products being produced include: phytoplankton chlorophyll-a concentration; remote-sensing reflectance at six wavelengths; total absorption and backscattering coefficients; phytoplankton absorption coefficient and absorption coefficients for dissolved and detrital material; and the diffuse attenuation coefficient for downwelling irradiance for light of wavelength 490nm. Information on uncertainties is also provided.\r\n\r\nPlease note, this dataset has been superseded. Later versions of the data are now available.",
    "keywords": "ESA, CCI, Ocean Colour, Geographic",
    "publicationState": "published",
    "dataPublishedTime": "2020-07-01T09:56:44",
    "doiPublishedTime": null,
    "updateFrequency": "notPlanned",
    "status": "superseded",
    "result_field": {
        "ob_id": "https://api.catalogue.ceda.ac.uk/api/v2/observations/30642/?format=api",
        "dataPath": "/neodc/esacci/ocean_colour/data/v4.2-release/climatology/netcdf/monthly/v4.2/",
        "oldDataPath": [],
        "storageLocation": "internal",
        "storageStatus": "online",
        "volume": 14221221562,
        "numberOfFiles": 13,
        "fileFormat": "Data are in NetCDF format"
    },
    "timePeriod": "https://api.catalogue.ceda.ac.uk/api/v2/times/8339/?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/1633/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/6019/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/6020/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/12066/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/12261/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/12262/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/12263/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/12264/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/12265/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/12266/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/18461/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/18462/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/18463/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/18464/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/18465/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/18466/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/18467/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/18468/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/18469/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/18470/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/18471/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/18472/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/18576/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/18597/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/21136/?format=api"
    ],
    "dataLineage": "These data were produced by the ESA Ocean Colour CCI project and provided to CEDA in the context of the ESA CCI Open Data Portal project.\r\nThis dataset forms part of the v4.2 ocean colour dataset collection that can be cited with the following DOI:  10.5285/d62f7f801cb54c749d20e736d4a1039",
    "removedDataTime": null,
    "removedDataReason": "",
    "language": "English",
    "identifier_set": [],
    "projects": [
        "https://api.catalogue.ceda.ac.uk/api/v2/projects/13365/?format=api"
    ],
    "observationcollection_set": [
        "https://api.catalogue.ceda.ac.uk/api/v2/observationcollections/30608/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/observationcollections/30128/?format=api"
    ],
    "responsiblepartyinfo_set": [
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/132856/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/132857/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/132858/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/132859/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/132861/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/132860/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/145289/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/145290/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/132862/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/132863/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/132864/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/132865/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/132866/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/132867/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/132868/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/132869/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/132870/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/132871/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/132872/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/132873/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/132874/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/132875/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/132876/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/132877/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/132878/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/132879/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/132880/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/132881/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/132882/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/132883/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/132884/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/132885/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/132886/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/132887/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/132888/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/132889/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/132890/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/132891/?format=api"
    ],
    "procedureAcquisition": null,
    "procedureCompositeProcess": null,
    "procedureComputation": "https://api.catalogue.ceda.ac.uk/api/v2/computations/28111/?format=api",
    "permissions": [
        {
            "ob_id": "https://api.catalogue.ceda.ac.uk/api/v2/observations/2538/?format=api",
            "useLimitation": null,
            "accessConstraints": null,
            "accessCategory": "public",
            "accessRoles": null,
            "label": "public: None group",
            "licenceURL": "https://artefacts.ceda.ac.uk/licences/specific_licences/esacci_oc_terms_and_conditions.pdf",
            "licenceClassifications": "any"
        }
    ],
    "discoveryKeywords": [
        {
            "ob_id": 1138,
            "name": "NDGO0003"
        }
    ]
}