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

{
    "ob_id": 31872,
    "uuid": "2cc63301f1854239aa61c70e58c61207",
    "title": "ESA Greenhouse Gases Climate Change Initiative (GHG_cci): Column-averaged carbon dioxide from TANSAT, generated with the OCFP algorithm, for selected validation sites, 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.  The data covers the period from March 2017 to May 2018 and is provided for TCCON (Total Carbon Column Observing Network) validation sites only.  A full global dataset is in production.     For further information on the dataset, please see the linked documentation.\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": "citable",
    "dataPublishedTime": "2020-09-29T13:22:53",
    "doiPublishedTime": "2020-10-05T10:53:42",
    "updateFrequency": "notPlanned",
    "status": "completed",
    "result_field": {
        "ob_id": "https://api.catalogue.ceda.ac.uk/api/v2/observations/31914/?format=api",
        "dataPath": "/neodc/esacci/ghg/data/cci_plus/CO2_TAN_OCFP/v1.0/",
        "oldDataPath": [],
        "storageLocation": "internal",
        "storageStatus": "online",
        "volume": 116249978,
        "numberOfFiles": 327,
        "fileFormat": "Data are in NetCDF format"
    },
    "timePeriod": "https://api.catalogue.ceda.ac.uk/api/v2/times/8747/?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/50416/?format=api",
        "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/66452/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/66456/?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/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": [
        "https://api.catalogue.ceda.ac.uk/api/v2/identifiers/10752/?format=api"
    ],
    "projects": [
        "https://api.catalogue.ceda.ac.uk/api/v2/projects/13295/?format=api"
    ],
    "observationcollection_set": [
        "https://api.catalogue.ceda.ac.uk/api/v2/observationcollections/30128/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/observationcollections/12808/?format=api"
    ],
    "responsiblepartyinfo_set": [
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/140721/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/140723/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/140724/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/140725/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/140726/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/140727/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/141058/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/140722/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/141059/?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"
        }
    ]
}