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

{
    "ob_id": 37617,
    "uuid": "81f53dc4487b4260b92d4dd8000a8b09",
    "title": "Chapter 2 of the Working Group I Contribution to the IPCC Sixth Assessment Report - input data for Figure 2.29 (v20220624)",
    "abstract": "Input data for Figure 2.29 from Chapter 2 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 2.29 shows the surface ocean pH evolution over time from the last 65 million years onwards up to modern times.  \r\n\r\n\r\n---------------------------------------------------\r\n How to cite this dataset\r\n ---------------------------------------------------\r\n When 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\nGulev, S.K., P.W. Thorne, J. Ahn, F.J. Dentener, C.M. Domingues, S. Gerland, D. Gong, D.S. Kaufman, H.C. Nnamchi, J. Quaas, J.A. Rivera, S. Sathyendranath, S.L. Smith, B. Trewin, K. von Schuckmann, and R.S. Vose, 2021: Changing State of the Climate System. 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. 287–422, doi:10.1017/9781009157896.004.\r\n\r\n\r\n---------------------------------------------------\r\n Figure subpanels\r\n ---------------------------------------------------\r\n The figure has four panels, with input data provided for panel d Ocean-SODA (the remaining datasets used for this figure are publicly available and reference is provided in Supplementary Material for chapter 2, Table 2.SM.1) \r\n\r\n\r\n---------------------------------------------------\r\n List of data provided\r\n ---------------------------------------------------\r\n This dataset contains global mean surface ocean pH from 1981-2018 for reconstructed global ocean acidification change.\r\n\r\n\r\n---------------------------------------------------\r\n Data provided in relation to figure\r\n ---------------------------------------------------\r\n Panel d (time series plot)\r\n \r\n - Data file: SODA_pH.txt (yearly data, 1981-2018); relates to purple line\r\n\r\nSODA stands for Satellite Oceanographic Datasets for Acidification.\r\n\r\n---------------------------------------------------\r\n Notes on reproducing the figure from the provided data\r\n ---------------------------------------------------\r\n Use program Chapter2_Fig.29_code_in_R to reproduce the figure (programming in R). \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 2)\r\n - Link to the Supplementary Material for Chapter 2, which contains details on the input data used in Table 2.SM.1\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, Ocean acidification, ocean pH levels",
    "publicationState": "citable",
    "dataPublishedTime": "2023-05-15T14:54:16",
    "doiPublishedTime": "2023-07-04T15:19:04.931209",
    "updateFrequency": "notPlanned",
    "status": "ongoing",
    "result_field": {
        "ob_id": "https://api.catalogue.ceda.ac.uk/api/v2/observations/37621/?format=api",
        "dataPath": "/badc/ar6_wg1/data/ch_02/inputdata_ch2_fig29/v20220624",
        "oldDataPath": [],
        "storageLocation": "internal",
        "storageStatus": "online",
        "volume": 4884,
        "numberOfFiles": 4,
        "fileFormat": "Data provided in .txt format"
    },
    "timePeriod": "https://api.catalogue.ceda.ac.uk/api/v2/times/10387/?format=api",
    "geographicExtent": "https://api.catalogue.ceda.ac.uk/api/v2/bboxes/529/?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/12630/?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/32717/?format=api"
    ],
    "responsiblepartyinfo_set": [
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/179517/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/179518/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/179519/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/179520/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/179521/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/179522/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/179523/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/179524/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/179525/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/179526/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/179527/?format=api"
    ],
    "procedureAcquisition": null,
    "procedureCompositeProcess": null,
    "procedureComputation": "https://api.catalogue.ceda.ac.uk/api/v2/computations/37619/?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": []
}