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

{
    "ob_id": 33333,
    "uuid": "38bac9051d064d4da183fff2361f5de8",
    "title": "Chapter 3 of the Working Group I Contribution to the IPCC Sixth Assessment Report - Input data for Figure 3.27 (v20220621)",
    "abstract": "Input data for figure  3.27 from Chapter 3 of the Working Group I (WGI) Contribution to the Intergovernmental Panel on Climate Change (IPCC) Sixth Assessment Report (AR6).\r\n\r\nFigure 3.27 shows maps of multi-decadal salinity trends for the near-surface ocean.\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\nEyring, V., N.P. Gillett, K.M. Achuta Rao, R. Barimalala, M. Barreiro Parrillo, N. Bellouin, C. Cassou, P.J. Durack, Y. Kosaka, S. McGregor, S. Min, O. Morgenstern, and Y. Sun, 2021: Human Influence on 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. 423–552, doi:10.1017/9781009157896.005.\r\n\r\n  ---------------------------------------------------\r\n  Figure subpanels\r\n  ---------------------------------------------------\r\n  The figure has two subpanels, with input data provided for the upper panel.\r\n\r\n  ---------------------------------------------------\r\n  List of data provided\r\n  ---------------------------------------------------\r\n  This dataset contains the global ocean salinity estimates from Durack & Wijffels (2010) based on observations from 01-01-1950 to 12-31-2019:\r\n  \r\n  - Mean salinity (for the Jan/1950 to Dec/2019 period, units in PSS).\r\n  - Salinity change (for the same period, PSS/70-years).\r\n  - Salinity change error (same period, PSS/70-years).\r\n\r\n  ---------------------------------------------------\r\n  Notes on reproducing the figure from the provided data\r\n  ---------------------------------------------------\r\nThe observational data from here (top panel) is taken from the file:\r\nDurackandWijffels_GlobalOceanChanges_19500101-20191231__210122-205355_beta.nc. The fields of interest are salinity_mean (shown as black contours) and salinity_change (shown in colourscale). DurackandWijffels_GlobalOceanChanges_19500101-20191231__210122-205355_beta.nc is an updated file from Durack & Wijffels (2010).\r\n\r\nThe data file DurackandWijffels_GlobalOceanChanges_19500101-20191231__210122-205355_beta.nc is an intermediate file used in 3.27, please refer to the code to generate the figure using the corresponding tools (see the link to the code in the 'Related document' section README_AR6_WG1_Chap3_Figure3_27_GlobalSeaSurfaceSalinitytrends.md at main ESMValGroup/ESMValTool-AR6-OriginalCode-FinalFigures).\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 report component containing the figure (Chapter 3)\r\n  - Link to the code for the figure, archived on Zenodo.\r\n  - Link to input data figure 2.27.\r\n  - Link to the figure on the IPCC AR6 website.",
    "keywords": "IPCC-DDC, IPCC, AR6, WG1, WGI, Sixth Assessment Report, Working Group I, Physical Science Basis, Chapter 3, Human influence, large-scale indicators, Natural variability, anthropogenically-forced change, observed changes",
    "publicationState": "citable",
    "dataPublishedTime": "2022-12-14T16:38:04",
    "doiPublishedTime": "2023-02-08T19:38:31.554442",
    "updateFrequency": "notPlanned",
    "status": "ongoing",
    "result_field": {
        "ob_id": "https://api.catalogue.ceda.ac.uk/api/v2/observations/37606/?format=api",
        "dataPath": "/badc/ar6_wg1/data/ch_03/inputdata_ch3_fig27/v20220621",
        "oldDataPath": [],
        "storageLocation": "internal",
        "storageStatus": "online",
        "volume": 40251095,
        "numberOfFiles": 4,
        "fileFormat": "netCDF"
    },
    "timePeriod": "https://api.catalogue.ceda.ac.uk/api/v2/times/9150/?format=api",
    "geographicExtent": "https://api.catalogue.ceda.ac.uk/api/v2/bboxes/529/?format=api",
    "nonGeographicFlag": false,
    "phenomena": [
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/1050/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/1635/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/1636/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/9042/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/9043/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/9045/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/49483/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/49484/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/49485/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/49486/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/49487/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/49488/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/49489/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/49490/?format=api"
    ],
    "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\n Data 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/12391/?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/32718/?format=api"
    ],
    "responsiblepartyinfo_set": [
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/148869/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/148870/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/148871/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/148872/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/148873/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/148874/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/148875/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/148876/?format=api"
    ],
    "procedureAcquisition": null,
    "procedureCompositeProcess": null,
    "procedureComputation": "https://api.catalogue.ceda.ac.uk/api/v2/computations/33334/?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": []
}