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

{
    "ob_id": 27811,
    "uuid": "a3b6d7f93e5c4ea986f3622eeee2b96f",
    "title": "IPCC AR5 reference regions",
    "abstract": "The boundaries of a set of regions which are defined in Chapter 14 of the Working Group 1 (WGI) contribution to the 2013 Intergovernmental Panel on Climate Change (IPCC) Fifth Assessment Report (AR5) and in the AR5 Annex I Atlas of Global and Regional Climate Projections.  The regions are used for the calculation of IPCC regional climate statistics.\r\n\r\nThe regions used to calculate regional climate statistics in AR5 are the 26 SREX regions defined by the IPCC Special Report on Managing the Risks of Extreme Events and Disasters to Advance Climate Change Adaptation (IPCC, 2012: also known as \"SREX\"). For AR5  an additional 7 regions containing the two polar regions, the Caribbean, Indian Ocean and Pacific Island States have been added.  In total there are 33 region boundaries and of these,  4 (the Arctic, Antarctic, South Asia and South-East Asia) are used twice for land-only and sea-only analysis, giving a total of 37 IPCC analysis regions.\r\n\r\nEach of the 33 regions is provided with a name and a label. The label is set to the three letter code used in the SREX report for the 26 SREX regions. The 7 additional reference regions are also given three letter short names.\r\n\r\nThe 26 SREX regions are: Alaska/NW Canada (ALA), Eastern Canada/Greenland/Iceland (CGI), Western North America (WNA), Central North America (CNA), Eastern North America (ENA), Central America/Mexico (CAM), Amazon (AMZ), NE Brazil (NEB), West Coast South America (WSA), South- Eastern South America (SSA), Northern Europe (NEU), Central Europe (CEU), Southern Europe/the Mediterranean (MED), Sahara (SAH), Western Africa (WAF), Eastern Africa (EAF), Southern Africa (SAF), Northern Asia (NAS), Western Asia (WAS), Central Asia (CAS), Tibetan Plateau (TIB), Eastern Asia (EAS), Southern Asia (SAS), Southeast Asia (SEA), Northern Australia (NAS) and Southern Australia/New Zealand (SAU).\r\n\r\nThe non-SREX reference regions are: Antarctica (ANT), Arctic (ARC), Caribbean (CAR), Western Indian Ocean (WIO), Northern Tropical Pacific (NTP), Equatorial Tropical Pacific (ETP) and Southern Tropical Pacific (STP). \r\n\r\nThe region definitions have a subtlety regarding the treatment of land and sea areas which needs to be handled with care. The climate models use a range of methods for dealing with coastal boundaries. The archived data includes a field giving the proportion of each model grid cell which is land or sea. A model grid cell is considered land if more that 50% of the cell is land. The mean for a given region is then defined in terms of the grid points (which are the cell centres) which are within the specified reference boundaries. The spatial area covered by these grid cells will then differ from model to model. The reference boundaries thus provide a starting point for defining the regional means: the means are not a simple average of these areas. The distinction is not expected to be substantial, but anyone wanting to reproduce exactly the same numbers will need to follow all steps carefully.",
    "keywords": "IPCC AR5 Regions IPCC-DDC regional CMIP CMIP3 CMIP5 SREX",
    "publicationState": "published",
    "dataPublishedTime": "2021-03-22T14:55:13",
    "doiPublishedTime": null,
    "updateFrequency": "",
    "status": "completed",
    "result_field": {
        "ob_id": "https://api.catalogue.ceda.ac.uk/api/v2/observations/27812/?format=api",
        "dataPath": "/badc/ipcc-ddc-regions/data/ar5/regions",
        "oldDataPath": [],
        "storageLocation": "internal",
        "storageStatus": "online",
        "volume": 257865,
        "numberOfFiles": 10,
        "fileFormat": "The 33 reference region boundaries are archived in Environmental Systems Research Institute (Esri) shapefile format (.shp, .shx and .dbf), with an additional projections file (.prj) to specify the projection. Users should be aware that the projections file is widely used, but is not part of the Esri standard (the standard does not provide any means of specifying the projection). It is thus possible that software designed to support a narrow, and technically accurate, interpretation of the standard will not pick up the information in the projections file.\r\n\r\nIn addition to the Esri shapefile data the reference regions are also provided in human-readable .xls and .cvs format containing the longitude-latitude coordinates of the region boundary vertices.  A .jpeg file shows the regions on a map, it is produced from the Esri shapefile data with a sample .r script which is also included in this dataset.\r\n\r\nThe file format suffixes contained in this dataset are: .csv .xls .json .jpg .r .dbf .shp .shx .prj"
    },
    "timePeriod": null,
    "geographicExtent": "https://api.catalogue.ceda.ac.uk/api/v2/bboxes/2444/?format=api",
    "nonGeographicFlag": false,
    "phenomena": [],
    "dataLineage": "The boundaries of a set of regions which are defined in Chapter 14 of the Working Group 1 (WGI) contribution to the 2013 Intergovernmental Panel on Climate Change (IPCC) Fifth Assessment Report (AR5) and in the AR5 Annex I Atlas of Global and Regional Climate Projections.",
    "removedDataTime": null,
    "removedDataReason": "",
    "language": "English",
    "identifier_set": [],
    "projects": [
        "https://api.catalogue.ceda.ac.uk/api/v2/projects/426/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/projects/11975/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/projects/26579/?format=api"
    ],
    "observationcollection_set": [
        "https://api.catalogue.ceda.ac.uk/api/v2/observationcollections/5525/?format=api"
    ],
    "responsiblepartyinfo_set": [
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/116960/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/116955/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/116957/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/116958/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/116959/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/116961/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/116962/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/116966/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/116954/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/116963/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/116967/?format=api"
    ],
    "procedureAcquisition": null,
    "procedureCompositeProcess": null,
    "procedureComputation": null,
    "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": [
        {
            "ob_id": 1138,
            "name": "NDGO0003"
        }
    ]
}