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

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

{
    "ob_id": 10886,
    "uuid": "b2e553261448fcbed284612e5b4bae58",
    "title": "Data from AVHRR-3 at Metop-A for the Eumetsat Polar System Project",
    "abstract": "AVHRR-3 scans the Earth's surface in six spectral bands in the range of 0.58-12.5 microns, to provide day and night imaging of land, water and clouds and measurements of sea surface temperature, ice snow and vegetation cover. The instruments were provided by the National Oceanic and Atmospheric Administration (NOAA) and is flown on the EPS-METOP series of satellites\r\n\r\nThis dataset contains data from the Advanced Very High Resolution Radiometer-3 (AVHRR-3) on board the Eumetsat Polar System (EPS) MetOp-A satellite.",
    "keywords": "AVHRR-3, radiometric, images",
    "publicationState": "published",
    "dataPublishedTime": "2009-06-11T14:27:34",
    "doiPublishedTime": null,
    "updateFrequency": "asNeeded",
    "status": "ongoing",
    "result_field": {
        "ob_id": "https://api.catalogue.ceda.ac.uk/api/v2/observations/32895/?format=api",
        "dataPath": "/neodc/avhrr3_metop_a/data/l1b",
        "oldDataPath": [
            "https://api.catalogue.ceda.ac.uk/api/v2/results/10887/?format=api"
        ],
        "storageLocation": "internal",
        "storageStatus": "online",
        "volume": 31941089779577,
        "numberOfFiles": 75157,
        "fileFormat": "Data are in EUMETSAT native format"
    },
    "timePeriod": "https://api.catalogue.ceda.ac.uk/api/v2/times/3021/?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/21955/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/22848/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/24567/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/25844/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/25845/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/25847/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/25868/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/25872/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/25900/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/25906/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/25940/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/25942/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/25945/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/25994/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/25999/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/26022/?format=api"
    ],
    "dataLineage": "Data collected and prepared by EUMETSAT before a copy of the data were obtained by NEODC directly from EUMETSAT",
    "removedDataTime": null,
    "removedDataReason": "",
    "language": "English",
    "identifier_set": [
        "https://api.catalogue.ceda.ac.uk/api/v2/identifiers/7249/?format=api"
    ],
    "projects": [
        "https://api.catalogue.ceda.ac.uk/api/v2/projects/8205/?format=api"
    ],
    "observationcollection_set": [
        "https://api.catalogue.ceda.ac.uk/api/v2/observationcollections/10885/?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/39170/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/39175/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/39169/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/39172/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/39173/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/39174/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/39176/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/39171/?format=api"
    ],
    "procedureAcquisition": null,
    "procedureCompositeProcess": "https://api.catalogue.ceda.ac.uk/api/v2/composites/10891/?format=api",
    "procedureComputation": null,
    "permissions": [
        {
            "ob_id": "https://api.catalogue.ceda.ac.uk/api/v2/observations/2634/?format=api",
            "useLimitation": null,
            "accessConstraints": null,
            "accessCategory": "registered",
            "accessRoles": null,
            "label": "registered: None group",
            "licenceURL": "https://artefacts.ceda.ac.uk/licences/specific_licences/avhrr-3.pdf",
            "licenceClassifications": "unstated"
        }
    ],
    "discoveryKeywords": [
        {
            "ob_id": 1138,
            "name": "NDGO0003"
        }
    ]
}