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

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

{
    "ob_id": 34607,
    "uuid": "41d0dfd6d2064b158f244c0123c83972",
    "title": "FIDUCEO: Fundamental Climate Data Record of brightness temperatures for High-resolution Infrared Radiation Sounder (HIRS)  1978 - 2016, V2.0",
    "abstract": "The FIDelity and Uncertainty in Climate data records from Earth Observations (FIDUCEO) project Fundamental Climate Data Record of brightness temperatures for the High-resolution Infrared Radiation Sounder (HIRS) contains brightness temperatures for HIRS for all editions of HIRS/2, HIRS/2I, HIRS/3, and HIRS/4 satellite instruments. It contains HIRS l1b data as available from the NOAA Comprehensive Large Array-Data Stewardship System (CLASS).  Geolocation and calibration information is available in the files.  For more information and relevant product guides please see the documentation section. This data set was used as input to the Fundamental Climate Data Record of recalibrated brightness temperatures for the High-resolution Infrared Radiation Sounder (HIRS) with uncertainties, 1978 - 2016, v1.0 dataset.",
    "keywords": "FIDUCEO, HIRS, Brightness Temperature",
    "publicationState": "published",
    "dataPublishedTime": "2022-08-10T17:50:15",
    "doiPublishedTime": null,
    "updateFrequency": "",
    "status": "completed",
    "result_field": {
        "ob_id": "https://api.catalogue.ceda.ac.uk/api/v2/observations/37607/?format=api",
        "dataPath": "/neodc/fiduceo/data/fcdr/hirs/v2.00/",
        "oldDataPath": [],
        "storageLocation": "internal",
        "storageStatus": "online",
        "volume": 1786452362336,
        "numberOfFiles": 728665,
        "fileFormat": "HIRS- NOAA Native Binary format: Data formats for HIRS/2 (NOAA-14 and before) are documented in the NOAA  POD User's Guide. available online in PDF linked to in the documentation section"
    },
    "timePeriod": "https://api.catalogue.ceda.ac.uk/api/v2/times/7557/?format=api",
    "geographicExtent": "https://api.catalogue.ceda.ac.uk/api/v2/bboxes/529/?format=api",
    "nonGeographicFlag": false,
    "phenomena": [],
    "dataLineage": "Data was originally downloaded by the University of Hamburg from the NOAA class archive.  It was transferred to the JASMIN FIDUCEO group work space and restructured for project purposes.  It was then supplied to CEDA for archival by Jon Mittaz of the University of Reading.",
    "removedDataTime": null,
    "removedDataReason": "",
    "language": "English",
    "identifier_set": [],
    "projects": [
        "https://api.catalogue.ceda.ac.uk/api/v2/projects/5002/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/projects/8448/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/projects/27632/?format=api"
    ],
    "observationcollection_set": [],
    "responsiblepartyinfo_set": [
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/164250/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/164247/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/164246/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/164240/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/164243/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/164245/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/164242/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/164241/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/180645/?format=api"
    ],
    "procedureAcquisition": "https://api.catalogue.ceda.ac.uk/api/v2/acquisitions/37848/?format=api",
    "procedureCompositeProcess": null,
    "procedureComputation": null,
    "permissions": [
        {
            "ob_id": "https://api.catalogue.ceda.ac.uk/api/v2/observations/2591/?format=api",
            "useLimitation": null,
            "accessConstraints": null,
            "accessCategory": "public",
            "accessRoles": null,
            "label": "public: None group",
            "licenceURL": "https://artefacts.ceda.ac.uk/licences/specific_licences/NOAA%20Open%20Access%20Data.pdf",
            "licenceClassifications": "any"
        }
    ],
    "discoveryKeywords": [
        {
            "ob_id": 1138,
            "name": "NDGO0003"
        }
    ]
}