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

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

{
    "ob_id": 8407,
    "uuid": "85a414f72c8312439b176495ec240e0b",
    "title": "CALIPSO: Cloud and Aerosol Lidar Level 2 Vertical Feature Mask Version 3-02 Product (CAL_LID_L2_VFM-ValStage1-V3-02)",
    "abstract": "The Cloud-Aerosol Lidar and Infrared Pathfinder Satellite Observation (CALIPSO) was a joint-mission between NASA and the French space agency Centre National d'Etudes Spatiales. The main objectives of the mission was to supply unique data set of vertical cloud and aerosol profiles.\r\n\r\nThis dataset contains cloud and aerosol lidar level 2 vertical feature mask version 3-02 data product, which describes the horizontal and vertical distribution of the cloud and the aerosol layers observed by the Cloud-Aerosol Lidar with Orthogonal Polarization (CALIOP). Version 3-02 marks the transition to a new cluster computing system without any changes in the algorithm used in version 3-01. The resulting impact on the products are very minor.",
    "keywords": "NASA, CALIPSO, CALIOP, Cloud, Aerosol",
    "publicationState": "published",
    "dataPublishedTime": "2014-07-25T15:48:35",
    "doiPublishedTime": null,
    "updateFrequency": "notPlanned",
    "status": "completed",
    "result_field": {
        "ob_id": "https://api.catalogue.ceda.ac.uk/api/v2/observations/8408/?format=api",
        "dataPath": "/neodc/caliop/data/l2_vfm/v3-02",
        "oldDataPath": [],
        "storageLocation": "internal",
        "storageStatus": "online",
        "volume": 542750846248,
        "numberOfFiles": 36959,
        "fileFormat": "Data are HDF4 formatted"
    },
    "timePeriod": "https://api.catalogue.ceda.ac.uk/api/v2/times/2405/?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/64153/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/64154/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/64155/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/64161/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/65024/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/65033/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/65044/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/65048/?format=api"
    ],
    "dataLineage": "These data were obtained from the NASA Langley Research Center Atmospheric Science Data Center and mirrored by the NEODC",
    "removedDataTime": null,
    "removedDataReason": "",
    "language": "English",
    "identifier_set": [
        "https://api.catalogue.ceda.ac.uk/api/v2/identifiers/5377/?format=api"
    ],
    "projects": [
        "https://api.catalogue.ceda.ac.uk/api/v2/projects/8349/?format=api"
    ],
    "observationcollection_set": [
        "https://api.catalogue.ceda.ac.uk/api/v2/observationcollections/8346/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/observationcollections/30129/?format=api"
    ],
    "responsiblepartyinfo_set": [
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/33493/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/33495/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/33496/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/33497/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/42788/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/42789/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/33499/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/33494/?format=api"
    ],
    "procedureAcquisition": null,
    "procedureCompositeProcess": "https://api.catalogue.ceda.ac.uk/api/v2/composites/8411/?format=api",
    "procedureComputation": null,
    "permissions": [
        {
            "ob_id": "https://api.catalogue.ceda.ac.uk/api/v2/observations/2559/?format=api",
            "useLimitation": null,
            "accessConstraints": null,
            "accessCategory": "registered",
            "accessRoles": null,
            "label": "registered: None group",
            "licenceURL": "https://eosweb.larc.nasa.gov/citing-asdc-data",
            "licenceClassifications": "any"
        }
    ],
    "discoveryKeywords": [
        {
            "ob_id": 1138,
            "name": "NDGO0003"
        }
    ]
}