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

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

{
    "ob_id": 43401,
    "uuid": "a0fa32d5872545bb93c5e9616aa020d4",
    "title": "DMS concentrations in the Antarctic Peninsula",
    "abstract": "This dataset contains the time series of dimethyl sulfate (DMS) concentrations measured at East Beach Hut near the British Antarctic Survey (BAS) Rothera station off the coast of the Antarctic peninsula since late Feb 2022, as part of the Southern Ocean Clouds (SOC) project.\r\n\r\nThe data was collected using an iDirac gas chromatograph. DMS is naturally emitted from the oceans into the atmosphere, and has a direct effect on climate through cloud formation.\r\n\r\nThis data is openly accessible for research purposes. Please do contact the authors if you plan to use this data for publications.",
    "keywords": "DMS,dimethyl sulfide,iDirac,VOCs,Antarctica",
    "publicationState": "citable",
    "dataPublishedTime": "2025-03-20T15:36:07",
    "doiPublishedTime": "2025-04-07T08:59:32.481391",
    "updateFrequency": "notPlanned",
    "status": "ongoing",
    "result_field": {
        "ob_id": "https://api.catalogue.ceda.ac.uk/api/v2/observations/43466/?format=api",
        "dataPath": "/badc/deposited2025/Southern_Ocean_Clouds/dms_rothera",
        "oldDataPath": [],
        "storageLocation": "internal",
        "storageStatus": "online",
        "volume": 685812,
        "numberOfFiles": 2,
        "fileFormat": "BADC-CSV"
    },
    "timePeriod": "https://api.catalogue.ceda.ac.uk/api/v2/times/12037/?format=api",
    "geographicExtent": "https://api.catalogue.ceda.ac.uk/api/v2/bboxes/4677/?format=api",
    "nonGeographicFlag": false,
    "phenomena": [
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/80066/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/80068/?format=api"
    ],
    "dataLineage": "Raw chromatogram from the iDirac were converted into concentrations as described in Bolas et al., AMT, 2020. Data underwent QA/QC procedures as described in Bolas et al.",
    "removedDataTime": null,
    "removedDataReason": "",
    "language": "English",
    "identifier_set": [
        "https://api.catalogue.ceda.ac.uk/api/v2/identifiers/13291/?format=api"
    ],
    "projects": [
        "https://api.catalogue.ceda.ac.uk/api/v2/projects/43402/?format=api"
    ],
    "observationcollection_set": [],
    "responsiblepartyinfo_set": [
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/206982/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/206559/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/206560/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/206561/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/206562/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/206563/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/206803/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/206558/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/206804/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/206805/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/206806/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/206807/?format=api"
    ],
    "procedureAcquisition": "https://api.catalogue.ceda.ac.uk/api/v2/acquisitions/43403/?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": []
}