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

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

{
    "ob_id": 3924,
    "uuid": "529c36e0838b2c4e08215d7bb90594ad",
    "title": "GOSTAPlus - GISST 2.2 SST and sea ice content data",
    "abstract": "The Global Ocean Surface Temperature Atlas Plus (GOSTAplus) contains maps of Sea Surface Temperature (SST) climatologies and anomalies, Night Marine Air temperature climatologies and anomalies and Sea Ice coverage spanning the period 1851-1995. Dataset includes gridded, global SSTs from 1951-1990 and Sea Ice coverage from 1903 to 1994. The data are provided by the Met Office. Updated version of some data also available on request (to 1998).",
    "keywords": "Gosta, atlas, temperature, GISST, climatology, anomalies",
    "publicationState": "published",
    "dataPublishedTime": "2007-02-02T17:28:27",
    "doiPublishedTime": null,
    "updateFrequency": "notPlanned",
    "status": "completed",
    "result_field": {
        "ob_id": "https://api.catalogue.ceda.ac.uk/api/v2/observations/3925/?format=api",
        "dataPath": "/badc/ukmo-gosta/data/gostaplus_cd_update",
        "oldDataPath": [],
        "storageLocation": "internal",
        "storageStatus": "online",
        "volume": 31121479,
        "numberOfFiles": 8,
        "fileFormat": "Hierarchical Data Format and Binary Format"
    },
    "timePeriod": "https://api.catalogue.ceda.ac.uk/api/v2/times/1119/?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/21884/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/21885/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/21886/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/21887/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/21888/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/21891/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/21892/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/21894/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/21895/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/21898/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/21900/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/21903/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/21904/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/21905/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/21906/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/21907/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/21908/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/25388/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/25888/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/25891/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/25892/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/25898/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/25900/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/25905/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/25938/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/25939/?format=api"
    ],
    "dataLineage": "Data prepared by the Global Ocean Surface Temperature Atlas (GOSTA) project and then sent to BADC on CD-ROM for wider dissemination on request. The data are stored in Hierarchical Data Format (HDF) on the HDF format CD-ROM. A Unix BINARY (2 bytes) version of this CD-ROM is now separately available.",
    "removedDataTime": null,
    "removedDataReason": "",
    "language": "English",
    "identifier_set": [
        "https://api.catalogue.ceda.ac.uk/api/v2/identifiers/2675/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/identifiers/8751/?format=api"
    ],
    "projects": [
        "https://api.catalogue.ceda.ac.uk/api/v2/projects/13164/?format=api"
    ],
    "observationcollection_set": [
        "https://api.catalogue.ceda.ac.uk/api/v2/observationcollections/3917/?format=api"
    ],
    "responsiblepartyinfo_set": [
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/19260/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/19263/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/19256/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/19261/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/19257/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/19255/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/19258/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/19259/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/53191/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/19262/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/55493/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/148635/?format=api"
    ],
    "procedureAcquisition": null,
    "procedureCompositeProcess": null,
    "procedureComputation": "https://api.catalogue.ceda.ac.uk/api/v2/computations/3926/?format=api",
    "permissions": [
        {
            "ob_id": "https://api.catalogue.ceda.ac.uk/api/v2/observations/2600/?format=api",
            "useLimitation": null,
            "accessConstraints": null,
            "accessCategory": "restricted",
            "accessRoles": "gosta",
            "label": "restricted: gosta group",
            "licenceURL": "https://artefacts.ceda.ac.uk/licences/specific_licences/ukmo_agreement.pdf",
            "licenceClassifications": "academic"
        }
    ],
    "discoveryKeywords": [
        {
            "ob_id": 1138,
            "name": "NDGO0003"
        }
    ]
}