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

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

{
    "ob_id": 4813,
    "uuid": "95c40a73dfe7f77c2e0203ec6d566e8e",
    "title": "Convective Storm Initiation Project (CSIP): UK Met Office Near-Real-Time (NRT) Data",
    "abstract": "Near real time output from the Met Office's operational Unified Model (UM) supplied participants of the Convective Storm Initiation Project (CSIP) aimed to further the understanding of the mechanisms responsible for the initiation of precipitating convection in the maritime environment of southern England. \r\n\r\nThe CSIP project aimed to understand why convective clouds form and develop into precipitating clouds in a particular location. The project was centred on the 3 GHz (CAMRa) and 1275 clear-air (ACROBAT) radars at Chilbolton and used a number of the new UK Universities' Facility for Atmospheric Measurement (UFAM) mobile instruments.",
    "keywords": "CSIP, Met Office, model",
    "publicationState": "published",
    "dataPublishedTime": "2006-08-17T08:43:29",
    "doiPublishedTime": null,
    "updateFrequency": "notPlanned",
    "status": "completed",
    "result_field": {
        "ob_id": "https://api.catalogue.ceda.ac.uk/api/v2/observations/4814/?format=api",
        "dataPath": "/badc/csip/data/ukmo-nrt",
        "oldDataPath": [],
        "storageLocation": "internal",
        "storageStatus": "online",
        "volume": 14534119,
        "numberOfFiles": 97,
        "fileFormat": "Data are gif formatted."
    },
    "timePeriod": "https://api.catalogue.ceda.ac.uk/api/v2/times/3761/?format=api",
    "geographicExtent": "https://api.catalogue.ceda.ac.uk/api/v2/bboxes/86/?format=api",
    "nonGeographicFlag": false,
    "phenomena": [],
    "dataLineage": "Data from the UK Met Office's Unified Model were supplied to the Convective Storm Initiation Project (CSIP) participants and then to the BADC for archiving.",
    "removedDataTime": null,
    "removedDataReason": "",
    "language": "English",
    "identifier_set": [
        "https://api.catalogue.ceda.ac.uk/api/v2/identifiers/3220/?format=api"
    ],
    "projects": [
        "https://api.catalogue.ceda.ac.uk/api/v2/projects/4614/?format=api"
    ],
    "observationcollection_set": [
        "https://api.catalogue.ceda.ac.uk/api/v2/observationcollections/4611/?format=api"
    ],
    "responsiblepartyinfo_set": [
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/21898/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/21899/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/21900/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/21901/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/21897/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/21903/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/42964/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/42967/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/54573/?format=api"
    ],
    "procedureAcquisition": "https://api.catalogue.ceda.ac.uk/api/v2/acquisitions/4816/?format=api",
    "procedureCompositeProcess": null,
    "procedureComputation": null,
    "permissions": [
        {
            "ob_id": "https://api.catalogue.ceda.ac.uk/api/v2/observations/2532/?format=api",
            "useLimitation": null,
            "accessConstraints": null,
            "accessCategory": "restricted",
            "accessRoles": "ukmo_wx",
            "label": "restricted: ukmo_wx group",
            "licenceURL": "https://artefacts.ceda.ac.uk/licences/specific_licences/ukmo_agreement.pdf",
            "licenceClassifications": "academic"
        },
        {
            "ob_id": "https://api.catalogue.ceda.ac.uk/api/v2/observations/2533/?format=api",
            "useLimitation": null,
            "accessConstraints": null,
            "accessCategory": "restricted",
            "accessRoles": "ukmo_wx_gov",
            "label": "restricted: ukmo_wx_gov group",
            "licenceURL": "https://artefacts.ceda.ac.uk/licences/specific_licences/ukmo_agreement_gov.pdf",
            "licenceClassifications": "policy"
        }
    ],
    "discoveryKeywords": [
        {
            "ob_id": 1138,
            "name": "NDGO0003"
        }
    ]
}