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

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

{
    "ob_id": 39745,
    "uuid": "27273a9683be4c6991911c66535334ca",
    "title": "UK and Europe Methane (CH4) surface flux inverse modelling estimates for 2015 - 2019",
    "abstract": "Monthly CH4 flux estimates for the UK and western Europe, derived from inverse modelling work by the Atmospheric Chemistry Research Group (ACRG) at the University of Bristol.\r\nPosterior flux estimates were derived from a Markov Chain Monte Carlo (MCMC) inversion process, using 4-hourly atmospheric mole fraction observations of CH4 from UK observation sites Mace Head (MHD), Tacolneston (TAC), Ridge Hill (RGL), Bilsdale (BSD) and Heathfield (HFD) and a priori estimate of CH4 emissions from the UK Greenhouse Gas (UKGHG) and Emissions Database for Global Atmospheric Research (EDGAR) models. Total CH4 flux estimates at a resolution of 0.23 degrees latitude x 0.35 degrees longitude over 10.7 to 79.3 degrees north and -97.9 to 39.7 degrees east are provided for 2015 - 2019.",
    "keywords": "Methane",
    "publicationState": "published",
    "dataPublishedTime": "2023-02-16T09:23:11",
    "doiPublishedTime": null,
    "updateFrequency": "notPlanned",
    "status": "ongoing",
    "result_field": {
        "ob_id": "https://api.catalogue.ceda.ac.uk/api/v2/observations/39746/?format=api",
        "dataPath": "/badc/deposited2023/ACRG_monthly_methane_inversion/",
        "oldDataPath": [],
        "storageLocation": "internal",
        "storageStatus": "online",
        "volume": 110001889,
        "numberOfFiles": 3,
        "fileFormat": "Data are netCDF formatted"
    },
    "timePeriod": "https://api.catalogue.ceda.ac.uk/api/v2/times/11000/?format=api",
    "geographicExtent": "https://api.catalogue.ceda.ac.uk/api/v2/bboxes/3769/?format=api",
    "nonGeographicFlag": false,
    "phenomena": [
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/66297/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/66298/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/66299/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/66300/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/66301/?format=api"
    ],
    "dataLineage": "CH4 flux estimates produced during 2021 and reprocessed in Nov 2022 by Alice Ramsden before uploading to CEDA.",
    "removedDataTime": null,
    "removedDataReason": "",
    "language": "English",
    "identifier_set": [],
    "projects": [
        "https://api.catalogue.ceda.ac.uk/api/v2/projects/39747/?format=api"
    ],
    "observationcollection_set": [],
    "responsiblepartyinfo_set": [
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/193562/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/193563/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/193564/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/193565/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/193566/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/193567/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/193572/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/193573/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/193574/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/193575/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/193576/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/193577/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/193578/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/193579/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/193580/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/193581/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/193582/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/193583/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/193584/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/193585/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/193586/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/193587/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/193588/?format=api"
    ],
    "procedureAcquisition": null,
    "procedureCompositeProcess": null,
    "procedureComputation": "https://api.catalogue.ceda.ac.uk/api/v2/computations/39748/?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": []
}