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

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

{
    "ob_id": 41345,
    "uuid": "aeb9345956454f0b8d66bb6e078d55ec",
    "title": "Single Particle Soot Photometer (SP2) data from SASSO project - Version 0",
    "abstract": "This dataset contains number and mass concentration data of refractory black carbon (rBC) from the University of Manchester Single Particle Soot Photometer (SP2). Data were collected at the University of Exeter wildFIRE lab, between May and June 2019, and at the University of Manchester, between January and February 2020 as part of the Soot Aerodynamic Size Selection for Optical properties (SASSO) project. These data were used to derive the refractive index of black carbon aerosols.\r\nThis version 0 dataset contains black carbon concentrations. The SP2 instrument (Droplet Measurement Technologies, Colorado, USA) is operated by University of Manchester scientists.",
    "keywords": "SP2, Black carbon, SASSO, Single Particle Soot Photometer, man-sp2",
    "publicationState": "published",
    "dataPublishedTime": "2024-07-31T09:37:40",
    "doiPublishedTime": null,
    "updateFrequency": "notPlanned",
    "status": "completed",
    "result_field": {
        "ob_id": "https://api.catalogue.ceda.ac.uk/api/v2/observations/41627/?format=api",
        "dataPath": "/badc/deposited2024/SASSO/SASSO_MAN_SP2_LABdata",
        "oldDataPath": [],
        "storageLocation": "internal",
        "storageStatus": "online",
        "volume": 10066392,
        "numberOfFiles": 11,
        "fileFormat": "Data are BADC-CSV formatted"
    },
    "timePeriod": "https://api.catalogue.ceda.ac.uk/api/v2/times/11491/?format=api",
    "geographicExtent": null,
    "nonGeographicFlag": true,
    "phenomena": [
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/84623/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/84624/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/84625/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/84626/?format=api"
    ],
    "dataLineage": "Data were collected by the University of Manchester instrument scientists before preparation for archiving and delivery to the BADC.",
    "removedDataTime": null,
    "removedDataReason": "",
    "language": "English",
    "identifier_set": [],
    "projects": [
        "https://api.catalogue.ceda.ac.uk/api/v2/projects/38101/?format=api"
    ],
    "observationcollection_set": [],
    "responsiblepartyinfo_set": [
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/201284/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/201285/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/201286/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/201287/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/201288/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/201289/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/201291/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/202886/?format=api"
    ],
    "procedureAcquisition": "https://api.catalogue.ceda.ac.uk/api/v2/acquisitions/41346/?format=api",
    "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": []
}