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

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

{
    "ob_id": 4031,
    "uuid": "7e81155a2a11aa3719b39b2b77083e0d",
    "title": "Surface Radiation Budget (SRB): Daily and Monthly average measurements of radiative fluxes from March 1985 to December 1988",
    "abstract": "The NASA Surface Radiation Budget (SRB) project computes Top-of atmosphere and Surface radiative fluxes at a 1ox 1o spatial scale for both shortwave (0.28– 4 mm) and longwave (4 mm) wavelengths.\r\n\r\nThis dataset contains Version 1.1 Surface Radiation Budget (SRB) shortwave products for the period from March 1985 until December 1988 as produced by the World Climate Research Programme's (WCRP) SRB Satellite Data Analysis Center (SDAC). The data are derived from results from the International Satellite Cloud Climatology Project (ISCCP) and the Earth Radiation Budget Experiment (ERBE).",
    "keywords": "SRB, remote sensing, cloud",
    "publicationState": "published",
    "dataPublishedTime": "2014-09-22T05:36:23",
    "doiPublishedTime": null,
    "updateFrequency": "notPlanned",
    "status": "completed",
    "result_field": {
        "ob_id": "https://api.catalogue.ceda.ac.uk/api/v2/observations/4032/?format=api",
        "dataPath": "/badc/CDs/srb/data",
        "oldDataPath": [],
        "storageLocation": "internal",
        "storageStatus": "online",
        "volume": 440369664,
        "numberOfFiles": 95,
        "fileFormat": "Data are HDF formatted"
    },
    "timePeriod": "https://api.catalogue.ceda.ac.uk/api/v2/times/3740/?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/21911/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/21919/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/21962/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/22353/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/23422/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/23423/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/25846/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/25875/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/25884/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/25892/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/25901/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/25916/?format=api"
    ],
    "dataLineage": "CD-ROM obtained from NASA Langley and made available, as is, for browsing purposes from the BADC archive.",
    "removedDataTime": null,
    "removedDataReason": "",
    "language": "English",
    "identifier_set": [
        "https://api.catalogue.ceda.ac.uk/api/v2/identifiers/2764/?format=api"
    ],
    "projects": [
        "https://api.catalogue.ceda.ac.uk/api/v2/projects/13985/?format=api"
    ],
    "observationcollection_set": [
        "https://api.catalogue.ceda.ac.uk/api/v2/observationcollections/4030/?format=api"
    ],
    "responsiblepartyinfo_set": [
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/19613/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/19618/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/19612/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/19615/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/19616/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/19617/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/19619/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/19614/?format=api"
    ],
    "procedureAcquisition": null,
    "procedureCompositeProcess": null,
    "procedureComputation": "https://api.catalogue.ceda.ac.uk/api/v2/computations/19243/?format=api",
    "permissions": [
        {
            "ob_id": "https://api.catalogue.ceda.ac.uk/api/v2/observations/2528/?format=api",
            "useLimitation": null,
            "accessConstraints": null,
            "accessCategory": "public",
            "accessRoles": null,
            "label": "public: None group",
            "licenceURL": "http://creativecommons.org/licenses/by/4.0/",
            "licenceClassifications": "any"
        }
    ],
    "discoveryKeywords": [
        {
            "ob_id": 1138,
            "name": "NDGO0003"
        }
    ]
}