GET

Observation Instance

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/32176/?format=api
HTTP 200 OK
Allow: GET, HEAD, OPTIONS
Content-Type: application/json
Vary: Accept

{
    "ob_id": 32176,
    "uuid": "905032bf592d46cba7effe558b79145d",
    "title": "Methane Observations and Yearly Assessments (MOYA): lower troposphere greenhouse gas data taken over Pantanal, Mato Grosso do Sul, Brazil",
    "abstract": "This dataset contains CH4, CO2, CO, N2O and SF6 dry air molar fraction vertical profiles over the Pantanal, Mato Grosso do Sul, Brazil with air sampled using small aircraft and analysed at Laboratório de Gases de Efeito Estufa (LAGEE), Sao Jose dos Campos, Brazil.\r\n\r\nThe air was sampled during ascent of small airplane from 4.4 km above surface down to close to the ground. A series of flasks (17 flasks) were filled sequentially. The flasks were contained in a suitcase. Valves of the flasks were opened and closed by a programmable microcontroller. After sampling the suitcase were sent by mail to the high precision gas analytics laboratory LAGEE at Instituto Nacional de Pesquisas Espaciais (INPE), Sao Jose dos Campos, Brazil where the dry air molar fractions of the air of each flask were measured.\r\n\r\nThese data were collected as part of the Methane Observations and Yearly Assessments (MOYA) project funded by the Natural Environment Research Council (NERC) (NE/N016211/1).",
    "keywords": "MOYA, Methane, greenhouse gas, dry air,  NERC",
    "publicationState": "citable",
    "dataPublishedTime": "2021-03-08T11:25:13",
    "doiPublishedTime": "2021-03-08T14:17:47.982561",
    "updateFrequency": "notPlanned",
    "status": "completed",
    "result_field": {
        "ob_id": "https://api.catalogue.ceda.ac.uk/api/v2/observations/32181/?format=api",
        "dataPath": "/badc/moya/data/aircraft/pantanal-greenhouse",
        "oldDataPath": [],
        "storageLocation": "internal",
        "storageStatus": "online",
        "volume": 120756,
        "numberOfFiles": 8,
        "fileFormat": "Data are BADC-CSV formatted."
    },
    "timePeriod": "https://api.catalogue.ceda.ac.uk/api/v2/times/8821/?format=api",
    "geographicExtent": "https://api.catalogue.ceda.ac.uk/api/v2/bboxes/2731/?format=api",
    "nonGeographicFlag": false,
    "phenomena": [
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/55134/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/55137/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/55140/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/55144/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/55145/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/55146/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/89123/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/89124/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/89125/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/89126/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/89127/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/89128/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/89129/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/89130/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/89131/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/89132/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/89133/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/89134/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/89135/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/89136/?format=api"
    ],
    "dataLineage": "Data were collected locally and sent to RHUL for analysis 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/10810/?format=api"
    ],
    "projects": [
        "https://api.catalogue.ceda.ac.uk/api/v2/projects/24718/?format=api"
    ],
    "observationcollection_set": [
        "https://api.catalogue.ceda.ac.uk/api/v2/observationcollections/24762/?format=api"
    ],
    "responsiblepartyinfo_set": [
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/143065/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/143066/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/143067/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/143068/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/143069/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/143071/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/143070/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/143083/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/143084/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/168397/?format=api"
    ],
    "procedureAcquisition": "https://api.catalogue.ceda.ac.uk/api/v2/acquisitions/32180/?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"
        }
    ]
}