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/43993/?format=api
HTTP 200 OK
Allow: GET, HEAD, OPTIONS
Content-Type: application/json
Vary: Accept

{
    "ob_id": 43993,
    "uuid": "1c393ac015a34388be31c053d43c26dd",
    "title": "COSHAIR: UK Integrated Assessment Model (UKIAM) Maps of PM2.5 and NO2 Concentrations",
    "abstract": "The Community Scenarios Of Hydrogen Energy And Impacts On Air Pollution (COSHAIR) examines a range of scenarios from 01/01/2020 to 01/01/2050 with different levels of hydrogen take-up, in different sectors, to understand the consequences for air pollution. The scenarios investigate the potential implications of hydrogen production and use in the energy system on UK air pollution. These scenarios were produced using the UK TIMES energy system model at University College London. This represents all substantive UK energy flows and greenhouse gas emissions. \r\nThe UK Integrated Assessment Model (UKIAM) at Imperial College was used to examine the changes in air quality that might occur in the future due to adopting hydrogen in the scenarios. \r\nData contains the ASCII files, compatible with QGIS, for the spatially apportioned UK concentrations of PM2.5 (particulate matter with a diameter of 2.5 micrometres or less) and NO2 (Nitrogen Dioxide) using the UKIAM framework. \r\nThe supporting information provides full descriptions of the scenario names:\r\n\r\nNDB - No Decarbonisation Baseline (no hydrogen, non-net zero)\r\nNZC - Net Zero Counterfactual (net zero, no hydrogen)\r\nLS - Likely Scenario (net zero, limited hydrogen)\r\nLPS - Likely and Possible Scenario (net zero, higher hydrogen)\r\nUS - Unlikely Scenario (net zero, highest hydrogen)",
    "keywords": "Air pollution modelling,Fine particulate matter,Nitrogen dioxide,Spatial mapping",
    "publicationState": "published",
    "dataPublishedTime": "2025-09-30T10:53:28",
    "doiPublishedTime": null,
    "updateFrequency": "notPlanned",
    "status": "completed",
    "result_field": {
        "ob_id": "https://api.catalogue.ceda.ac.uk/api/v2/observations/44849/?format=api",
        "dataPath": "/badc/deposited2025/COSHAIR_UKIAM_Maps/COSHAIR_UKIAM_Maps",
        "oldDataPath": [],
        "storageLocation": "internal",
        "storageStatus": "online",
        "volume": 197694809,
        "numberOfFiles": 53,
        "fileFormat": "ASCII"
    },
    "timePeriod": "https://api.catalogue.ceda.ac.uk/api/v2/times/12347/?format=api",
    "geographicExtent": "https://api.catalogue.ceda.ac.uk/api/v2/bboxes/4747/?format=api",
    "nonGeographicFlag": false,
    "phenomena": [],
    "dataLineage": "- Activity data produced from UK TIMES\r\n- Emission factors applied to activity data - predominantly emission factors from the National Atmospheric Emissions Inventory as well as comprehensive review of emission factors for hydrogen energy\r\n- Non-energy emissions sources taken from National Atmospheric Emissions Inventory baseline projections to 2040, carried forward to 2050\r\n- Emissions files fed into UKIAM for different scenarios and years",
    "removedDataTime": null,
    "removedDataReason": "",
    "language": "English",
    "identifier_set": [],
    "projects": [
        "https://api.catalogue.ceda.ac.uk/api/v2/projects/43994/?format=api"
    ],
    "observationcollection_set": [],
    "responsiblepartyinfo_set": [
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/210360/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/210361/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/210362/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/210363/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/210364/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/210365/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/210366/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/214791/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/210367/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/210368/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/210369/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/210370/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/210371/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/210372/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/210373/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/210374/?format=api"
    ],
    "procedureAcquisition": null,
    "procedureCompositeProcess": null,
    "procedureComputation": "https://api.catalogue.ceda.ac.uk/api/v2/computations/43995/?format=api",
    "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": []
}