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

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

{
    "ob_id": 30027,
    "uuid": "7abc197a062a448bb32a76d6f3371c66",
    "title": "Si-SOA: Concentration of water-soluble elements found in PM2.5 samples taken from Institue of Atmospheric Physics Beijing site in August 2018 and January 2019",
    "abstract": "This dataset contains both the concentration of PM2.5 in ambient air sampled at a height of 8 metres and the concentration of water-soluble elements found in the PM2.5 samples resulting from the analysis by  Inductively Coupled Plasma Mass Spectrometry (ICP-MS).  The PM2.5 samples were collected in the Institute of Atmospheric Physics, Chinese Academy of Sciences, China in August 2018 and January 2019.  \r\n\r\nThe data was collected to support the study of atmospheric chemistry and processes involving Silicon (Si)  containing fine particles, which potentially contribute to atmospheric pollution\r\n\r\nThese data were collected as part of the Silicon-containing secondary organic aerosols in ambient air (Si-SOA) Natural Environment Research Council (NERC) funded project.",
    "keywords": "SI-SOA, PM2.5, plasma mass spectrometry, ICP-MS",
    "publicationState": "published",
    "dataPublishedTime": "2020-02-18T09:06:12",
    "doiPublishedTime": null,
    "updateFrequency": "notPlanned",
    "status": "completed",
    "result_field": {
        "ob_id": "https://api.catalogue.ceda.ac.uk/api/v2/observations/30081/?format=api",
        "dataPath": "/badc/deposited2020/si-soa/data/plasma_mass_spectrometry",
        "oldDataPath": [],
        "storageLocation": "internal",
        "storageStatus": "online",
        "volume": 12354,
        "numberOfFiles": 2,
        "fileFormat": "Data are netCDF formatted."
    },
    "timePeriod": "https://api.catalogue.ceda.ac.uk/api/v2/times/8156/?format=api",
    "geographicExtent": "https://api.catalogue.ceda.ac.uk/api/v2/bboxes/2572/?format=api",
    "nonGeographicFlag": false,
    "phenomena": [
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/65473/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/65484/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/65490/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/65491/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/65503/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/65504/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/65505/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/65506/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/65507/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/65508/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/65509/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/65510/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/65511/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/65512/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/65513/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/65514/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/65515/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/65516/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/65517/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/65518/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/65519/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/65520/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/65521/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/65522/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/65523/?format=api"
    ],
    "dataLineage": "Data produced by University of Birmingham and uploaded to Centre for Environmental Data Anaylsis (CEDA) for archiving.",
    "removedDataTime": null,
    "removedDataReason": "",
    "language": "English",
    "identifier_set": [],
    "projects": [
        "https://api.catalogue.ceda.ac.uk/api/v2/projects/29996/?format=api"
    ],
    "observationcollection_set": [
        "https://api.catalogue.ceda.ac.uk/api/v2/observationcollections/30041/?format=api"
    ],
    "responsiblepartyinfo_set": [
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/129760/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/129761/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/129762/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/129763/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/129764/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/129766/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/129767/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/129765/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/168413/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/129768/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/129769/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/129770/?format=api"
    ],
    "procedureAcquisition": "https://api.catalogue.ceda.ac.uk/api/v2/acquisitions/30028/?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"
        }
    ]
}