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

{
    "ob_id": 3596,
    "uuid": "b7824e040083c8135bcf4aebeb00c922",
    "title": "905 nm Vaisala CT75K Lidar Ceilometer Data from the Chilbolton Facility for Atmospheric and Radio Research (CFARR) site, Hampshire, England, 1996- 2013",
    "abstract": "The Chilbolton Observatory, Hampshire, have had a Vaisala CT75K lidar ceilometer deployed since 13th September 1996. This dataset contains measurements of the range of first, second, and third cloud base from the lidar and attenuated backscatter coefficients of aerosols within the atmosphere from 1996 to 2013. Plots of the attenuated backscatter coefficient at different heights are also available.\r\n\r\nThe instrument has been regularly calibrated using the method described by O'Connor, Ewan J., Anthony J. Illingworth, Robin J. Hogan, 2004: A Technique for Auto-calibration of Cloud Lidar. J. Atmos. Oceanic Technol., 21, 777–786. doi: http://dx.doi.org/10.1175/1520-0426(2004)021<0777:ATFAOC>2.0.CO;2 . \r\n\r\nPrior to April 2014 this technique had been applied manually, but from 2014 this was automated to provide a routine, automated application of O'Connor et al's calibration technique. This also highlighted an instrument calibration drift not previously spotted in earlier data and so a corrected data have been added to the archive for the following periods (denoted by \"_cor1\" in the filename): 1st July 2003 – 31st December 2003, January 2006 to December 2012 and February and March 2013. Users should see the data quality notes for further details.\r\n\r\nFor post 2013 data please refer to the \"all-years\" dataset.",
    "keywords": "clouds, lidar, ceilometer, infrared, elastic backscattering, precipitation, cloud base",
    "publicationState": "citable",
    "dataPublishedTime": "2003-09-14T08:36:22",
    "doiPublishedTime": "2015-04-20T23:00:00",
    "updateFrequency": "notPlanned",
    "status": "completed",
    "result_field": {
        "ob_id": "https://api.catalogue.ceda.ac.uk/api/v2/observations/3597/?format=api",
        "dataPath": "/badc/chilbolton/data/lidar-ct75k-1996-2013/",
        "oldDataPath": [],
        "storageLocation": "internal",
        "storageStatus": "online",
        "volume": 37936652823,
        "numberOfFiles": 16732,
        "fileFormat": "Data are netCDF formatted\r\n"
    },
    "timePeriod": "https://api.catalogue.ceda.ac.uk/api/v2/times/3326/?format=api",
    "geographicExtent": "https://api.catalogue.ceda.ac.uk/api/v2/bboxes/92/?format=api",
    "nonGeographicFlag": false,
    "phenomena": [
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/1319/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/1320/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/22455/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/69767/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/69768/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/69769/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/69770/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/69771/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/69772/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/69773/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/69775/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/69777/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/69778/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/69779/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/69780/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/69781/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/69782/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/69783/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/69785/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/69787/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/69788/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/69789/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/69790/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/69791/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/69792/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/69793/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/69794/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/69795/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/69796/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/69797/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/69798/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/69799/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/69800/?format=api"
    ],
    "dataLineage": "Data were recorded continuously by the instrument at the Chilbolton site before post-processing using signals from optically thick strato-cumulus clouds to calibrate according to the method described by O'Connor, Ewan J., Anthony J. Illingworth, Robin J. Hogan, 2004: A Technique for Auto-calibration of Cloud Lidar. J. Atmos. Oceanic Technol., 21, 777–786. doi: http://dx.doi.org/10.1175/1520-0426(2004)021<0777:ATFAOC>2.0.CO;2.  The data were then deposited at the BADC for ingestion into the BADC archives.",
    "removedDataTime": null,
    "removedDataReason": "",
    "language": "English",
    "identifier_set": [
        "https://api.catalogue.ceda.ac.uk/api/v2/identifiers/2441/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/identifiers/8375/?format=api"
    ],
    "projects": [
        "https://api.catalogue.ceda.ac.uk/api/v2/projects/3464/?format=api"
    ],
    "observationcollection_set": [
        "https://api.catalogue.ceda.ac.uk/api/v2/observationcollections/3461/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/observationcollections/4611/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/observationcollections/7378/?format=api"
    ],
    "responsiblepartyinfo_set": [
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/15170/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/43450/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/15175/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/15169/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/43453/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/15171/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/15172/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/15173/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/43451/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/43452/?format=api"
    ],
    "procedureAcquisition": "https://api.catalogue.ceda.ac.uk/api/v2/acquisitions/3599/?format=api",
    "procedureCompositeProcess": null,
    "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"
        }
    ]
}