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

{
    "ob_id": 32607,
    "uuid": "9252ff9ddeb249a2bd8433e9ae9dfe13",
    "title": "ESA Greenhouse Gases Climate Change Initiative (GHG_cci): Column-averaged carbon dioxide from TANSAT, generated with the OCFP algorithm, for global land areas, version 1.0",
    "abstract": "This dataset contains column-average dry-air mole fractions of atmospheric carbon dioxide (CO2), derived from the TANSAT satellite, using the University of Leicester Full-Physics Retrieval Algorithm (UoL-FP, also known as OCFP). This dataset is also referred to as CO2_TAN_OCFP.  This version of the dataset provides data globally over land.    For further information on the dataset, please see the linked documentation.\r\n\r\nInitially this dataset contains two months of data (June and August 2017), delivered as part of the GHG_cci Climate Research Data Package 6.    Additional time periods will be added in the future.\r\n\r\n\r\nThis data has been produced as part of the European Space Agency (ESA)'s Climate Change Initiative (CCI) programme, with support from the UK's National Centre for Earth Observation (NCEO).",
    "keywords": "ESA, CCI, satellite, TANSAT, atmosphere, carbon dioxide, CO2",
    "publicationState": "published",
    "dataPublishedTime": "2021-08-06T10:42:35",
    "doiPublishedTime": null,
    "updateFrequency": "notPlanned",
    "status": "ongoing",
    "result_field": {
        "ob_id": "https://api.catalogue.ceda.ac.uk/api/v2/observations/33016/?format=api",
        "dataPath": "/neodc/esacci/ghg/data/cci_plus/CO2_TAN_OCFP/v1.0_global_land/",
        "oldDataPath": [],
        "storageLocation": "internal",
        "storageStatus": "online",
        "volume": 518692308,
        "numberOfFiles": 60,
        "fileFormat": "Data are in NetCDF format"
    },
    "timePeriod": "https://api.catalogue.ceda.ac.uk/api/v2/times/8956/?format=api",
    "geographicExtent": "https://api.catalogue.ceda.ac.uk/api/v2/bboxes/529/?format=api",
    "nonGeographicFlag": false,
    "phenomena": [
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/50542/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/50543/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/55535/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/63576/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/66452/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/66456/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/66719/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/68622/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/68624/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/68625/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/68626/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/68630/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/68635/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/68636/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/68637/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/68638/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/68639/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/68640/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/68641/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/68646/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/69372/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/69373/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/69374/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/69375/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/69629/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/69802/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/69803/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/69804/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/70614/?format=api"
    ],
    "dataLineage": "Data were processed by the ESA CCI GHG project team and supplied to CEDA as part of the ESA CCI Open Data Portal Project.      This data has been produced as part of the European Space Agency (ESA)'s Climate Change Initiative (CCI) programme, with support from the UK's National Centre for Earth Observation (NCEO).",
    "removedDataTime": null,
    "removedDataReason": "",
    "language": "English",
    "identifier_set": [],
    "projects": [
        "https://api.catalogue.ceda.ac.uk/api/v2/projects/13295/?format=api"
    ],
    "observationcollection_set": [
        "https://api.catalogue.ceda.ac.uk/api/v2/observationcollections/12808/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/observationcollections/30128/?format=api"
    ],
    "responsiblepartyinfo_set": [
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/145315/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/145319/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/145317/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/145316/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/145313/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/145314/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/145320/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/145318/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/145321/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/147415/?format=api"
    ],
    "procedureAcquisition": null,
    "procedureCompositeProcess": "https://api.catalogue.ceda.ac.uk/api/v2/composites/31873/?format=api",
    "procedureComputation": null,
    "permissions": [
        {
            "ob_id": "https://api.catalogue.ceda.ac.uk/api/v2/observations/2564/?format=api",
            "useLimitation": null,
            "accessConstraints": null,
            "accessCategory": "public",
            "accessRoles": null,
            "label": "public: None group",
            "licenceURL": "https://artefacts.ceda.ac.uk/licences/specific_licences/esacci_ghg_terms_and_conditions.pdf",
            "licenceClassifications": "any"
        }
    ],
    "discoveryKeywords": [
        {
            "ob_id": 1138,
            "name": "NDGO0003"
        },
        {
            "ob_id": 1140,
            "name": "ESACCI"
        }
    ]
}