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

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

{
    "ob_id": 20081,
    "uuid": "b70578ae62b745ec9dc2ba42d2ee1311",
    "title": "ESA Ocean Colour Climate Change Initiative (Ocean_Colour_cci): Global dataset of inherent optical properties (IOP) gridded on a sinusoidal projection, Version 2.0",
    "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 their Version 2.0 inherent optical properties (IOP) product (in mg/m3) on a sinusoidal projection at approximately 4 km spatial resolution and at a number of time resolutions (daily, 5-day, 8-day and monthly composites).   Note,  the IOP data are also included in the 'All Products' dataset. \r\n\r\nThe inherent optical properties (IOP) dataset consists of the total absorption and particle backscattering coefficients, and, additionally, the fraction of detrital & dissolved organic matter absorption and phytoplankton absorption. The total absorption (units m-1), the total backscattering (m-1), the absorption by detrital and coloured dissolved organic matter, the backscattering by particulate matter, and the absorption by phytoplankton share the same spatial resolution of ~4 km. The values of IOP are reported for the standard SeaWiFS wavelengths (412, 443, 490, 510, 555, 670nm). \r\n\r\nThis data product is on a sinusoidal equal-area grid projection, matching the NASA standard level 3 binned projection. The default number of latitude rows is 4320, which results in a vertical bin cell size of approximately 4 km. The number of longitude columns varies according to the latitude, which permits the equal area property. Unlike the NASA format, where the bin cells that do not contain any data are omitted, the CCI format retains all cells and simply marks empty cells with a NetCDF fill value. (A separate dataset is also available for data on a geographic projection.)\r\n\r\nPlease note, this dataset has been superseded. Later versions of the data are now available.",
    "keywords": "ESA, CCI, Ocean Colour, Sinusoidal",
    "publicationState": "published",
    "dataPublishedTime": "2016-12-12T17:01:30",
    "doiPublishedTime": null,
    "updateFrequency": "",
    "status": "superseded",
    "result_field": {
        "ob_id": "https://api.catalogue.ceda.ac.uk/api/v2/observations/20082/?format=api",
        "dataPath": "/neodc/esacci/ocean_colour/data/v2-release/sinusoidal/netcdf/iop/",
        "oldDataPath": [],
        "storageLocation": "internal",
        "storageStatus": "online",
        "volume": 6904794057143,
        "numberOfFiles": 8089,
        "fileFormat": "Data are in NetCDF"
    },
    "timePeriod": "https://api.catalogue.ceda.ac.uk/api/v2/times/5256/?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/12066/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/50512/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/52664/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/52665/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/55884/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/55885/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/55886/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/55887/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/55888/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/55889/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/55891/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/55892/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/55893/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/55894/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/55895/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/55896/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/55898/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/55899/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/55900/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/55901/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/55902/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/55903/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/55904/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/55905/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/55906/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/55907/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/62502/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/62503/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/62504/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/62505/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/87700/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/87701/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/87702/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/87703/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/87704/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/87705/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/87706/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/87707/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/87708/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/87709/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/87710/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/87711/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/87712/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/87713/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/87714/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/87715/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/87716/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/87717/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/87718/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/87719/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/87720/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/87721/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/87722/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/87723/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/87724/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/87725/?format=api"
    ],
    "dataLineage": "This data has been produced by the ESA Ocean Colour CCI project and provided to CEDA in the context of the ESA CCI Open Data Portal project",
    "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/13548/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/observationcollections/20073/?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/76368/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/76370/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/76371/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/76372/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/76556/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/104977/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/105200/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/105374/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/76373/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/76582/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/76608/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/76634/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/76660/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/76686/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/76712/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/76738/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/76764/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/76790/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/76816/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/76842/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/76868/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/76894/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/76920/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/76946/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/76972/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/76998/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/77024/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/77050/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/77076/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/77102/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/77128/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/77154/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/77180/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/77206/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/77232/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/77258/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/77284/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/77310/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/77336/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/77362/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/77388/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/77414/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/77440/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/77466/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/77492/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/77518/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/77544/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/77570/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/77596/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/77622/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/77648/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/77674/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/77700/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/77726/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/77752/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/77778/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/77804/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/77830/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/77856/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/77882/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/77908/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/77934/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/77960/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/77986/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/78012/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/78038/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/78064/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/78090/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/78116/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/78142/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/78168/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/78194/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/78220/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/78246/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/78272/?format=api"
    ],
    "procedureAcquisition": null,
    "procedureCompositeProcess": null,
    "procedureComputation": null,
    "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"
        }
    ]
}