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

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

{
    "ob_id": 41268,
    "uuid": "6285564c34a246fc9ba5ce053d85e5e7",
    "title": "ACSIS: Merged airborne chemistry data from instruments on board the FAAM aircraft",
    "abstract": "A collection of collated chemistry measurements made onboard the FAAM BAE-146 aircraft  for The North Atlantic Climate System Integrated Study: ACSIS project.  These data were collected by core and non-core instruments and compiled into a merged dataset. \r\n\r\nFlights included are from the measurement campaigns: ACSIS1 - February 2017, ACSIS2 - October 2017, ACSIS3 - May 2018, ACSIS4 - February 2019, ACSIS5 - August 2019, ACSIS6 - February 2020 and ACSIS7 - May 2022. Parameters include Carbon Dioxide (CO2), Methane (CH4), Nitric oxide (NO), Nitric dioxide (NO2), Total Organic Aerosol, Sulphate Aerosol, Nitrate Aerosol, Ammonium Aerosol, Chloride Aerosol, Urea (CH4N2O), Hydrogen cyanide (HCN), Nitryl chloride (ClNO2), and photolysis rates.",
    "keywords": "FAAM, chemistry",
    "publicationState": "citable",
    "dataPublishedTime": "2024-01-12T16:30:33",
    "doiPublishedTime": "2024-01-18T10:02:05",
    "updateFrequency": "",
    "status": "completed",
    "result_field": {
        "ob_id": "https://api.catalogue.ceda.ac.uk/api/v2/observations/41266/?format=api",
        "dataPath": "/badc/acsis/bae-146/merged-chemistry/",
        "oldDataPath": [],
        "storageLocation": "internal",
        "storageStatus": "online",
        "volume": 55447241,
        "numberOfFiles": 92,
        "fileFormat": "NASA-Ames, ICT"
    },
    "timePeriod": "https://api.catalogue.ceda.ac.uk/api/v2/times/11459/?format=api",
    "geographicExtent": "https://api.catalogue.ceda.ac.uk/api/v2/bboxes/4078/?format=api",
    "nonGeographicFlag": false,
    "phenomena": [
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/86152/?format=api"
    ],
    "dataLineage": "Data were produced by the project team and supplied for archiving at the Centre for Environmental Data Analysis (CEDA).",
    "removedDataTime": null,
    "removedDataReason": "",
    "language": "English",
    "identifier_set": [
        "https://api.catalogue.ceda.ac.uk/api/v2/identifiers/12803/?format=api"
    ],
    "projects": [
        "https://api.catalogue.ceda.ac.uk/api/v2/projects/24717/?format=api"
    ],
    "observationcollection_set": [
        "https://api.catalogue.ceda.ac.uk/api/v2/observationcollections/30143/?format=api"
    ],
    "responsiblepartyinfo_set": [
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/200870/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/200860/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/200861/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/200862/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/200863/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/200864/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/200865/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/200859/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/200866/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/200973/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/200974/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/200975/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/200867/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/200868/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/200869/?format=api"
    ],
    "procedureAcquisition": "https://api.catalogue.ceda.ac.uk/api/v2/acquisitions/41267/?format=api",
    "procedureCompositeProcess": null,
    "procedureComputation": null,
    "permissions": [
        {
            "ob_id": "https://api.catalogue.ceda.ac.uk/api/v2/observations/2526/?format=api",
            "useLimitation": null,
            "accessConstraints": null,
            "accessCategory": "public",
            "accessRoles": null,
            "label": "public: None group",
            "licenceURL": "http://www.nationalarchives.gov.uk/doc/open-government-licence/version/3/",
            "licenceClassifications": "any"
        }
    ],
    "discoveryKeywords": []
}