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

{
    "ob_id": 24920,
    "uuid": "717a3fd92989493aae6f4982fd5fca6c",
    "title": "Cloud Index retrievals from MIPAS ENVISAT L1B using MIPclouds algorithm",
    "abstract": "This data set contains retrievals from  Michelson Interferometer for Passive Atmospheric Sounding on Envisat  (MIPAS-ENVISAT) cloud and aerosol  and  contains information on derived cloud-top height (km), cloud-top temperature (K), cloud extinction (cm-1), with uncertainties. It also includes the measured radiance in the three cloud microwindow bands (832.0-834.4 cm-1, 1232.3-1234.4 cm-1, 1973.0-1983.0 cm-1), with noise equivalent spectral radiance values. Cloud index values are also included which can be used to distinguish different clouds types based on the index value.",
    "keywords": "MIPAS, Cloud Index, ENVISAT, cloud-top, cloud extinction",
    "publicationState": "published",
    "dataPublishedTime": "2017-08-09T11:58:54",
    "doiPublishedTime": null,
    "updateFrequency": "notPlanned",
    "status": "completed",
    "result_field": {
        "ob_id": "https://api.catalogue.ceda.ac.uk/api/v2/observations/24919/?format=api",
        "dataPath": "/neodc/mipas_clouds/data/v1.0",
        "oldDataPath": [],
        "storageLocation": "internal",
        "storageStatus": "online",
        "volume": 8219481926,
        "numberOfFiles": 2268,
        "fileFormat": "NetCDF"
    },
    "timePeriod": "https://api.catalogue.ceda.ac.uk/api/v2/times/6744/?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/25860/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/56235/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/56236/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/56237/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/56238/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/56239/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/56240/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/56241/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/56242/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/56243/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/56244/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/56245/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/56246/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/56247/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/56248/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/56249/?format=api"
    ],
    "dataLineage": "This work was funded by the National Centre for Earth Observation (NCEO) under the UK Natural Environment Research Council (NERC) and the ESA MIPclouds project.  Data were produced by the University of Leicester Earth Observation Science (Harjinder Sembhi, David Moore, John Remedios, Rosie Leigh) and the University of Oxford AOPP group (Anu Dudhia, Jane Hurley, Andrew Smith).  Data deposted by University of leicester with CEDA for archival.",
    "removedDataTime": null,
    "removedDataReason": "",
    "language": "English",
    "identifier_set": [
        "https://api.catalogue.ceda.ac.uk/api/v2/identifiers/9321/?format=api"
    ],
    "projects": [
        "https://api.catalogue.ceda.ac.uk/api/v2/projects/5002/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/projects/24926/?format=api"
    ],
    "observationcollection_set": [
        "https://api.catalogue.ceda.ac.uk/api/v2/observationcollections/30127/?format=api"
    ],
    "responsiblepartyinfo_set": [
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/102014/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/102005/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/102012/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/102013/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/102015/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/102016/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/102017/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/102018/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/102019/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/102009/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/101999/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/102010/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/102008/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/102007/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/102011/?format=api"
    ],
    "procedureAcquisition": null,
    "procedureCompositeProcess": "https://api.catalogue.ceda.ac.uk/api/v2/composites/24922/?format=api",
    "procedureComputation": null,
    "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"
        }
    ]
}