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

{
    "ob_id": 38253,
    "uuid": "cdabe9af5aa94608b227e6b9a96771f9",
    "title": "Chapter 6 of the Working Group I Contribution to the IPCC Sixth Assessment Report - data for Figure 6.17 (v20220928)",
    "abstract": "Data for Figure 6.17 from Chapter 6 of the Working Group I (WGI) Contribution to the Intergovernmental Panel on Climate Change (IPCC) Sixth Assessment Report (AR6).\r\n\r\n\r\nFigure 6.17 shows emission source-sector attribution of regional population-weighted mean concentrations of PM2.5 (fine particulate matter) and ozone for present-day emissions (year 2014).\r\n\r\n\r\n---------------------------------------------------\r\n How to cite this dataset\r\n ---------------------------------------------------\r\nWhen citing this dataset, please include both the data citation below (under 'Citable as') and the following citation for the report component from which the figure originates:\r\n Szopa, S., V. Naik, B. Adhikary, P. Artaxo, T. Berntsen, W.D. Collins, S. Fuzzi, L. Gallardo, A. Kiendler-Scharr, Z. Klimont, H. Liao, N. Unger, and P. Zanis, 2021: Short-Lived Climate Forcers. In Climate Change 2021: The Physical Science Basis. Contribution of Working Group I to the Sixth Assessment Report of the Intergovernmental Panel on Climate Change [Masson-Delmotte, V., P. Zhai, A. Pirani, S.L. Connors, C. Péan, S. Berger, N. Caud, Y. Chen, L. Goldfarb, M.I. Gomis, M. Huang, K. Leitzell, E. Lonnoy, J.B.R. Matthews, T.K. Maycock, T. Waterfield, O. Yelekçi, R. Yu, and B. Zhou (eds.)]. Cambridge University Press, Cambridge, United Kingdom and New York, NY, USA, pp. 817–922, doi:10.1017/9781009157896.008.\r\n\r\n\r\n---------------------------------------------------\r\n Figure subpanels\r\n ---------------------------------------------------\r\n The figure has two panels with data provided for all panels in one single directory.\r\n\r\n\r\n---------------------------------------------------\r\n List of data provided\r\n ---------------------------------------------------\r\n This dataset contains emission source-sector attribution of regional population-weighted mean concentrations for present-day emissions of:\r\n \r\n - Air pollutant  (PM2.5)\r\n - Ozone\r\n\r\n\r\nRegions: Eastern Asia, Latin America and Caribbean, North America, Eurasia, Southeast Asia and Developing Pacific, Europe, Africa, Middle East, Southern Asia, Asia-Pacific Developed.\r\n\r\nSource sector: Energy, Industry, Land and transportation, Shipping, Aviation, Residential and commercial, Agriculture, Waste management, Open biomass burning, Natural sources\r\n\r\n\r\n---------------------------------------------------\r\n Data provided in relation to figure\r\n ---------------------------------------------------\r\n Left panel:\r\n - Data file: PM25_regions_sectors_v210214.txt\r\n \r\n Right panel:\r\n - Data file: O3_regions_sectors_v210214.txt\r\n \r\nAdditional file: country-mapping_ISO-10Regions.csv: description of countries included in each region of the figure.\r\n\r\nPM2.5 refers to fine particulate matter air pollution with diameter of less than 2.5 microns\r\n\r\n\r\n---------------------------------------------------\r\n Sources of additional information\r\n ---------------------------------------------------\r\n The following weblinks are provided in the Related Documents section of this catalogue record:\r\n - Link to the figure on the IPCC AR6 website\r\n - Link to the report component containing the figure (Chapter 6)\r\n - Link to the Supplementary Material for Chapter 6, which contains details on the input data used in Table 6.SM.3\r\n - Link to the code for the figure, archived on Zenodo.",
    "keywords": "IPCC-DDC, IPCC, AR6, WG1, WGI, Sixth Assessment Report, Working Group 1, Physical Science Basis, PM2.5, ozone, concentrations, sectoral attribution, regional attribution",
    "publicationState": "citable",
    "dataPublishedTime": "2023-02-14T10:38:23",
    "doiPublishedTime": "2023-03-22T10:46:48.297076",
    "updateFrequency": "notPlanned",
    "status": "ongoing",
    "result_field": {
        "ob_id": "https://api.catalogue.ceda.ac.uk/api/v2/observations/38254/?format=api",
        "dataPath": "/badc/ar6_wg1/data/ch_06/ch6_fig17/v20220928",
        "oldDataPath": [],
        "storageLocation": "internal",
        "storageStatus": "online",
        "volume": 19793,
        "numberOfFiles": 6,
        "fileFormat": "Data are txt formatted"
    },
    "timePeriod": "https://api.catalogue.ceda.ac.uk/api/v2/times/10541/?format=api",
    "geographicExtent": "https://api.catalogue.ceda.ac.uk/api/v2/bboxes/3654/?format=api",
    "nonGeographicFlag": false,
    "phenomena": [],
    "dataLineage": "Data produced by Intergovernmental Panel on Climate Change (IPCC) authors and supplied for archiving at the Centre for Environmental Data Analysis (CEDA) by the Technical Support Unit (TSU) for IPCC Working Group I (WGI).\r\nData curated on behalf of the IPCC Data Distribution Centre (IPCC-DDC).",
    "removedDataTime": null,
    "removedDataReason": "",
    "language": "English",
    "identifier_set": [
        "https://api.catalogue.ceda.ac.uk/api/v2/identifiers/12426/?format=api"
    ],
    "projects": [
        "https://api.catalogue.ceda.ac.uk/api/v2/projects/32705/?format=api"
    ],
    "observationcollection_set": [
        "https://api.catalogue.ceda.ac.uk/api/v2/observationcollections/32721/?format=api"
    ],
    "responsiblepartyinfo_set": [
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/182159/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/182160/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/182161/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/182162/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/182163/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/182164/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/182165/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/182166/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/182167/?format=api"
    ],
    "procedureAcquisition": null,
    "procedureCompositeProcess": null,
    "procedureComputation": "https://api.catalogue.ceda.ac.uk/api/v2/computations/38255/?format=api",
    "permissions": [
        {
            "ob_id": "https://api.catalogue.ceda.ac.uk/api/v2/observations/2528/?format=api",
            "useLimitation": null,
            "accessConstraints": null,
            "accessCategory": "public",
            "accessRoles": null,
            "label": "public: None group",
            "licenceURL": "http://creativecommons.org/licenses/by/4.0/",
            "licenceClassifications": "any"
        }
    ],
    "discoveryKeywords": []
}