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

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

{
    "ob_id": 43129,
    "uuid": "ceaded7386ab4fb781e5344cb94db57d",
    "title": "ICECAPS-ACE: surface aerosol particle size distributions from the University of Leeds POPS 0288 instrument at Summit Station, Greenland, July-August 2023",
    "abstract": "This dataset contains surface aerosol particle size distribution measurements from Summit Station Greenland measured by a Handix Portable Optical Particle Spectrometer (POPS 1120, S/N: 0288). The POPS was connected to an omnidirectional total air inlet and installed on the roof of the Atmospheric Watch Observatory building at Summit Station.\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": "aerosol",
    "publicationState": "citable",
    "dataPublishedTime": "2024-08-07T10:23:30",
    "doiPublishedTime": "2024-08-07T10:24:41",
    "updateFrequency": "notPlanned",
    "status": "completed",
    "result_field": {
        "ob_id": "https://api.catalogue.ceda.ac.uk/api/v2/observations/43134/?format=api",
        "dataPath": "/badc/icecaps-ace/data/leeds-pops-0288",
        "oldDataPath": [],
        "storageLocation": "internal",
        "storageStatus": "online",
        "volume": 293780963,
        "numberOfFiles": 7,
        "fileFormat": "Data are NetCDF formattede"
    },
    "timePeriod": "https://api.catalogue.ceda.ac.uk/api/v2/times/11857/?format=api",
    "geographicExtent": "https://api.catalogue.ceda.ac.uk/api/v2/bboxes/2625/?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/62252/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/62253/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/63152/?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"
    ],
    "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/13169/?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/204814/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/204769/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/204770/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/204771/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/204772/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/204773/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/204774/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/204775/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/204776/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/204777/?format=api"
    ],
    "procedureAcquisition": "https://api.catalogue.ceda.ac.uk/api/v2/acquisitions/43135/?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"
        }
    ]
}