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

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

{
    "ob_id": 40639,
    "uuid": "f78cc9301a2149b5a9f07e0904b60634",
    "title": "POLCOMS-WAM model run in the Irish Sea generating eastward and northward currents at 32 depth layers for the CoFEE project for 11 years from 1996.",
    "abstract": "This dataset consists of eastward and northward current components at 32 depth levels. The dataset is a gridded dataset, with grid resolution of 1.85 km. It covers the entire Irish Sea area, with a precise range from -2.7 degrees longitude to -7 degrees longitude and from 51 degrees latitude to 56 degrees latitude. The data are daily averages and cover the period from 01 January 1996 to 01 January 2007. The eastward and northward current components were used as input conditions into a coastal processes and sediment transport model which looked at the response of the north Liverpool coastline to extreme flooding events. The dataset was generated by the Proudman Oceanographic Laboratory Coastal Ocean Modelling System coupled with the Wave Modelling model (POLCOMS-WAM) as part of the Natural Environment Research Council (NERC) CoFEE project which ran from April 2007 to September 2010. The dataset consists of 132 data files in Climate and Forecast (CF) compliant NetCDF format.",
    "keywords": "",
    "publicationState": "citable",
    "dataPublishedTime": "2023-08-22T09:02:38",
    "doiPublishedTime": "2023-08-22T09:02:38",
    "updateFrequency": "",
    "status": "final",
    "result_field": {
        "ob_id": "https://api.catalogue.ceda.ac.uk/api/v2/observations/40638/?format=api",
        "dataPath": "/bodc/POL090139/POLCOMS_WAM_32UV",
        "oldDataPath": [],
        "storageLocation": "internal",
        "storageStatus": "online",
        "volume": 53563333543,
        "numberOfFiles": 134,
        "fileFormat": "Climate and Forecast compliant NetCDFs"
    },
    "timePeriod": "https://api.catalogue.ceda.ac.uk/api/v2/times/11277/?format=api",
    "geographicExtent": "https://api.catalogue.ceda.ac.uk/api/v2/bboxes/3954/?format=api",
    "nonGeographicFlag": false,
    "phenomena": [
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/6023/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/50559/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/50561/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/86688/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/86689/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/86690/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/86691/?format=api"
    ],
    "dataLineage": "The data are archived on the British Oceanographic Data Centre (BODC)'s space at the Centre for Environmental Data Analysis (CEDA) and assigned a DOI. No quality control procedures were applied by BODC.",
    "removedDataTime": null,
    "removedDataReason": "",
    "language": "English",
    "identifier_set": [
        "https://api.catalogue.ceda.ac.uk/api/v2/identifiers/12703/?format=api"
    ],
    "projects": [],
    "observationcollection_set": [],
    "responsiblepartyinfo_set": [
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/197726/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/197724/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/197723/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/197722/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/197728/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/197729/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/197727/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/197725/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/197732/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/197730/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/197731/?format=api"
    ],
    "procedureAcquisition": null,
    "procedureCompositeProcess": null,
    "procedureComputation": null,
    "permissions": [
        {
            "ob_id": "https://api.catalogue.ceda.ac.uk/api/v2/observations/2569/?format=api",
            "useLimitation": null,
            "accessConstraints": null,
            "accessCategory": "public",
            "accessRoles": null,
            "label": "public: None group",
            "licenceURL": "https://www.bodc.ac.uk/data/documents/nodb/599476/",
            "licenceClassifications": "any"
        }
    ],
    "discoveryKeywords": []
}