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

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

{
    "ob_id": 43128,
    "uuid": "6b68b5e1ffd2467886386eaf0dfafd24",
    "title": "ICECAPS-ACE: Vertical aerosol particle size distributions from the University of Leeds POPS 0307 instrument collected via Helikite balloon above Summit Station, Greenland, July-August 2023",
    "abstract": "This dataset contains vertically resolved aerosol particle size distribution measurements collected using a tethered balloon platform at Summit Station, Greenland, in July and August 2023.\r\n\r\nAerosol particle size distributions were measured by a Handix Portable Optical Particle Spectrometer (POPS 1120, S/N: 0307). The POPS was placed in a lightweight insulating foam box, and a coarse mesh filter was placed over the inlet to prevent the growth of rime ice. The POPS was secured to the kite wing on the tethered balloon such that the inlet was always oriented into the wind.\r\n\r\nThese data were collected as part of the joint Natural Environmental Research Council (NERC) and US National Science Foundation (NSF) -funded Integrated Characterisation of Energy, Clouds, Atmospheric state, and Precipitation at Summit - Aerosol Cloud Experiment (ICECAPS-ACE) project.",
    "keywords": "",
    "publicationState": "citable",
    "dataPublishedTime": "2024-08-08T13:35:49",
    "doiPublishedTime": "2024-08-28T10:18:17",
    "updateFrequency": "notPlanned",
    "status": "completed",
    "result_field": {
        "ob_id": "https://api.catalogue.ceda.ac.uk/api/v2/observations/43127/?format=api",
        "dataPath": "/badc/icecaps-ace/data/leeds-pops-0307",
        "oldDataPath": [],
        "storageLocation": "internal",
        "storageStatus": "online",
        "volume": 25468140,
        "numberOfFiles": 10,
        "fileFormat": "Data are NetCDF formatted"
    },
    "timePeriod": "https://api.catalogue.ceda.ac.uk/api/v2/times/11857/?format=api",
    "geographicExtent": "https://api.catalogue.ceda.ac.uk/api/v2/bboxes/4576/?format=api",
    "nonGeographicFlag": false,
    "phenomena": [
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/53937/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/53938/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/53941/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/53942/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/53943/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/53944/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/58079/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/58081/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/62252/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/62253/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/74110/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/75050/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/75051/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/75052/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/75053/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/75054/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/75055/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/75056/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/75057/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/75058/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/75059/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/75060/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/75061/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/75062/?format=api"
    ],
    "dataLineage": "Data were collected by the University of Leeds in collaboration with the ICECAPS project team and deposited at the Centre for Environmental Data Analysis (CEDA) for archiving.",
    "removedDataTime": null,
    "removedDataReason": "",
    "language": "English",
    "identifier_set": [
        "https://api.catalogue.ceda.ac.uk/api/v2/identifiers/13178/?format=api"
    ],
    "projects": [
        "https://api.catalogue.ceda.ac.uk/api/v2/projects/30502/?format=api"
    ],
    "observationcollection_set": [],
    "responsiblepartyinfo_set": [
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/204815/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/204761/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/204762/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/204763/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/204764/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/204765/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/204766/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/204760/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/204767/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/204768/?format=api"
    ],
    "procedureAcquisition": "https://api.catalogue.ceda.ac.uk/api/v2/acquisitions/43133/?format=api",
    "procedureCompositeProcess": null,
    "procedureComputation": null,
    "permissions": [
        {
            "ob_id": "https://api.catalogue.ceda.ac.uk/api/v2/observations/2522/?format=api",
            "useLimitation": null,
            "accessConstraints": null,
            "accessCategory": "registered",
            "accessRoles": null,
            "label": "registered: None group",
            "licenceURL": "http://www.nationalarchives.gov.uk/doc/open-government-licence/version/3/",
            "licenceClassifications": "any"
        }
    ],
    "discoveryKeywords": [
        {
            "ob_id": 1138,
            "name": "NDGO0003"
        }
    ]
}