GET

Observation Instance

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/5707/?format=api
HTTP 200 OK
Allow: GET, HEAD, OPTIONS
Content-Type: application/json
Vary: Accept

{
    "ob_id": 5707,
    "uuid": "28f2a7c61e3dbb61a3212d31e728ddb7",
    "title": "RONOCO: Chemistry model output images",
    "abstract": "Supporting model output from the Met Office's Air Quality Unified Model (AQUM) were made available to participants during the NERC funded RONOCO (ROle of Nighttime chemistry in controlling the Oxidising Capacity of the AtmOsphere) consortium project. The overall objective of this consortium project was to advance substantially our understanding of night-time chemical processes and their impacts on the troposphere through a combined programme of instrument development, airborne measurements and numerical modelling. \r\n\r\nThis dataset contains model output images of chemical species. These data cover 2011 period only.",
    "keywords": "RONOCO, chemistry, model",
    "publicationState": "published",
    "dataPublishedTime": "2009-08-11T09:35:12",
    "doiPublishedTime": null,
    "updateFrequency": "notPlanned",
    "status": "completed",
    "result_field": {
        "ob_id": "https://api.catalogue.ceda.ac.uk/api/v2/observations/5708/?format=api",
        "dataPath": "/badc/ronoco/data/model-output-images",
        "oldDataPath": [],
        "storageLocation": "internal",
        "storageStatus": "online",
        "volume": 4265708263,
        "numberOfFiles": 15134,
        "fileFormat": "Images are PNG formatted"
    },
    "timePeriod": "https://api.catalogue.ceda.ac.uk/api/v2/times/1643/?format=api",
    "geographicExtent": "https://api.catalogue.ceda.ac.uk/api/v2/bboxes/115/?format=api",
    "nonGeographicFlag": false,
    "phenomena": [],
    "dataLineage": "Model data provided by the Met Office.\r\n",
    "removedDataTime": null,
    "removedDataReason": "",
    "language": "English",
    "identifier_set": [
        "https://api.catalogue.ceda.ac.uk/api/v2/identifiers/3747/?format=api"
    ],
    "projects": [
        "https://api.catalogue.ceda.ac.uk/api/v2/projects/5702/?format=api"
    ],
    "observationcollection_set": [
        "https://api.catalogue.ceda.ac.uk/api/v2/observationcollections/5699/?format=api"
    ],
    "responsiblepartyinfo_set": [
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/24606/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/24608/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/24609/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/24610/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/24612/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/41621/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/41622/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/24607/?format=api"
    ],
    "procedureAcquisition": null,
    "procedureCompositeProcess": null,
    "procedureComputation": "https://api.catalogue.ceda.ac.uk/api/v2/computations/475/?format=api",
    "permissions": [
        {
            "ob_id": "https://api.catalogue.ceda.ac.uk/api/v2/observations/2522/?format=api",
            "useLimitation": null,
            "accessConstraints": null,
            "accessCategory": "registered",
            "accessRoles": null,
            "label": "registered: None group",
            "licenceURL": "http://www.nationalarchives.gov.uk/doc/open-government-licence/version/3/",
            "licenceClassifications": "any"
        }
    ],
    "discoveryKeywords": [
        {
            "ob_id": 1138,
            "name": "NDGO0003"
        }
    ]
}