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

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

{
    "ob_id": 3616,
    "uuid": "0a65d66a1fcc93d9bedbe3eec0ff3e5a",
    "title": "ERBE: ERBE instrument measurements on aboard the Earth Radiation Budget Satellite (ERBS)",
    "abstract": "This dataset consists of data from the Earth Radiation Budget Experiment (ERBE) instrument on the NASA Earth Radiation Budget Satellite (ERBS), launched from the Space Shuttle Challenger in October 1984 (STS-41G). ERBS was placed into an orbit at 603-km altitude, 57-deg. inclination. \r\n\r\nThe ERBE instrument's main aim was to provide accurate measurements of incoming solar energy and shortwave and longwave radiation reflected or emitted from the Earth back into space. \r\n\r\nThis dataset contains colour images (shortwave/longwave/net radiation, albedo, clear-sky albedo, clear-sky shortwave/longwave/net radiation, and shortwave/longwave/net cloud forcing) from the ERBE instrument, a scanning radiometer on ERBS. \r\n\r\nMonthly average values are included for the time periods during which the scanners were operational.\r\n\r\nThis dataset is public, though NASA noted that this is intended for research purposes and the data has no commercial value.",
    "keywords": "ATMOSPHERICRADIATION ATMOSPHERE",
    "publicationState": "published",
    "dataPublishedTime": "1990-12-10T16:32:00",
    "doiPublishedTime": null,
    "updateFrequency": "notPlanned",
    "status": "completed",
    "result_field": {
        "ob_id": "https://api.catalogue.ceda.ac.uk/api/v2/observations/3617/?format=api",
        "dataPath": "/badc/CDs/erbe/erbedata/erbs/",
        "oldDataPath": [],
        "storageLocation": "internal",
        "storageStatus": "online",
        "volume": 78118804,
        "numberOfFiles": 1055,
        "fileFormat": "Data are GIF formatted"
    },
    "timePeriod": "https://api.catalogue.ceda.ac.uk/api/v2/times/1034/?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/22796/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/25846/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/25863/?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"
    ],
    "dataLineage": "Data collected by NASA using the Earth Radiation Budget Satellite (ERBS), processed and prepared by NASA. A copy of the data were then obtained by the BADC to be made available through the BADC archive.",
    "removedDataTime": null,
    "removedDataReason": "",
    "language": "English",
    "identifier_set": [
        "https://api.catalogue.ceda.ac.uk/api/v2/identifiers/2457/?format=api"
    ],
    "projects": [
        "https://api.catalogue.ceda.ac.uk/api/v2/projects/3618/?format=api"
    ],
    "observationcollection_set": [
        "https://api.catalogue.ceda.ac.uk/api/v2/observationcollections/3615/?format=api"
    ],
    "responsiblepartyinfo_set": [
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/15228/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/15232/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/15235/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/15227/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/15226/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/15229/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/15230/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/15231/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/15233/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/15234/?format=api"
    ],
    "procedureAcquisition": null,
    "procedureCompositeProcess": "https://api.catalogue.ceda.ac.uk/api/v2/composites/3620/?format=api",
    "procedureComputation": null,
    "permissions": [
        {
            "ob_id": "https://api.catalogue.ceda.ac.uk/api/v2/observations/2521/?format=api",
            "useLimitation": null,
            "accessConstraints": null,
            "accessCategory": "public",
            "accessRoles": null,
            "label": "public: None group",
            "licenceURL": "https://artefacts.ceda.ac.uk/licences/missing_licence.pdf",
            "licenceClassifications": "unstated"
        }
    ],
    "discoveryKeywords": [
        {
            "ob_id": 1138,
            "name": "NDGO0003"
        }
    ]
}