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

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

{
    "ob_id": 32841,
    "uuid": "7da8723b16e94771be1a2717d8a6e2fe",
    "title": "ESA Sea Surface Salinity Climate Change Initiative (Sea_Surface_Salinity_cci): Monthly sea surface salinity product, v03.21, for 2010 to 2020",
    "abstract": "The ESA Sea Surface Salinity Climate Change Initiative (CCI) consortium has produced global, level 4, multi-sensor Sea Surface Salinity maps covering the 2010-2020 period.\r\n\r\nThis dataset provides Sea Surface Salinity (SSS) data at a spatial resolution of 25 km and a time resolution of 1 month.  This has been spatially sampled on a 25 km EASE (Equal Area Scalable Earth) grid and 15 days of time sampling. A weekly product is also available.  In addition to salinity, information on errors are provided.  For more information, see the user guide and other product documentation available from the linked Sea Surface Salinity CCI web page.\r\n\r\nCompared to the previous version of the data, version 3 SSS and associated uncertainties are more precise and cover a longer period (Jan 2010-sept 2020); version 3 SSS are provided closer to land than version 2 SSS, with a possible degraded quality. Users might remove these additional near land data by using the lsc_qc flag.",
    "keywords": "ESA Climate Change Initiative, CCI, Sea Surface Salinity",
    "publicationState": "published",
    "dataPublishedTime": "2021-10-08T13:22:22",
    "doiPublishedTime": null,
    "updateFrequency": "notPlanned",
    "status": "superseded",
    "result_field": {
        "ob_id": "https://api.catalogue.ceda.ac.uk/api/v2/observations/33082/?format=api",
        "dataPath": "/neodc/esacci/sea_surface_salinity/data/v03.21/30days",
        "oldDataPath": [],
        "storageLocation": "internal",
        "storageStatus": "online",
        "volume": 1312695041,
        "numberOfFiles": 258,
        "fileFormat": "Data are netCDf formatted."
    },
    "timePeriod": "https://api.catalogue.ceda.ac.uk/api/v2/times/9156/?format=api",
    "geographicExtent": "https://api.catalogue.ceda.ac.uk/api/v2/bboxes/529/?format=api",
    "nonGeographicFlag": false,
    "phenomena": [
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/1050/?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/28227/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/28228/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/28230/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/28231/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/29289/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/29290/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/40158/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/40159/?format=api"
    ],
    "dataLineage": "Data are provided by the Sea Surface Salinity project as part of the ESA Climate Change Initiative programme, and delivered for long-term archiving at the Centre for Environmental Data Analysis (CEDA).",
    "removedDataTime": null,
    "removedDataReason": "",
    "language": "English",
    "identifier_set": [],
    "projects": [
        "https://api.catalogue.ceda.ac.uk/api/v2/projects/28235/?format=api"
    ],
    "observationcollection_set": [
        "https://api.catalogue.ceda.ac.uk/api/v2/observationcollections/32840/?format=api"
    ],
    "responsiblepartyinfo_set": [
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/146634/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/146626/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/146627/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/146628/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/146629/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/146630/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/146633/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/146631/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/146632/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/146635/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/146636/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/146637/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/146638/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/146639/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/146640/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/146641/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/146642/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/146643/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/146644/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/146645/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/146646/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/146647/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/146648/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/146649/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/146650/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/146651/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/146652/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/146653/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/146654/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/146655/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/146656/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/146657/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/146658/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/146659/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/146660/?format=api"
    ],
    "procedureAcquisition": null,
    "procedureCompositeProcess": "https://api.catalogue.ceda.ac.uk/api/v2/composites/29942/?format=api",
    "procedureComputation": null,
    "permissions": [
        {
            "ob_id": "https://api.catalogue.ceda.ac.uk/api/v2/observations/2550/?format=api",
            "useLimitation": null,
            "accessConstraints": null,
            "accessCategory": "public",
            "accessRoles": null,
            "label": "public: None group",
            "licenceURL": "https://artefacts.ceda.ac.uk/licences/specific_licences/esacci_salinity_terms_and_conditions.pdf",
            "licenceClassifications": "any"
        }
    ],
    "discoveryKeywords": [
        {
            "ob_id": 1138,
            "name": "NDGO0003"
        },
        {
            "ob_id": 1140,
            "name": "ESACCI"
        }
    ]
}