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

{
    "ob_id": 43996,
    "uuid": "ff5c7123668044be9876d6e690517990",
    "title": "CALIPSO: Cloud and Aerosol Lidar Level 2 1km Cloud Layer Version 4-51 Product (CAL_LID_L2_01kmCLay-V4-51)",
    "abstract": "The Cloud-Aerosol Lidar and Infrared Pathfinder Satellite Observation (CALIPSO) was a joint-mission between NASA and the French space agency Centre National d'Etudes Spatiales. The main objectives of the mission was to supply unique data set of vertical cloud and aerosol profiles.\r\n\r\nThis dataset contains cloud and aerosol lidar level 2 1km cloud layer version 4-51 data product, which provides cloud data derived from Cloud-Aerosol Lidar with Orthogonal Polarization (CALIOP) Level 1B product at 1 km horizontal resolution, with full complement of diagnostic and quality assurance parameters. The data provides range of parameters including vertical profile of cloud layers, optical depth. \r\n\r\nCAL_LID_L2_01kmCLay-Standard-V4-51 is the Cloud-Aerosol Lidar and Infrared Pathfinder Satellite Observations (CALIPSO) Lidar Level 2 1 km Cloud Layer, Version 4-51 data product. Data for this product was collected using the CALIPSO Cloud-Aerosol Lidar with Orthogonal Polarization (CALIOP) instrument.\r\n\r\nWithin this layer product are two general classes of data: Column Properties (including position data and viewing geometry) and Layer Properties. The lidar layer products contain column descriptors associated with several layer descriptors. The column descriptors specify the temporal and geophysical location of the column of the atmosphere through which a given lidar pulse travels. Also included in the column descriptors are indicators of surface lighting conditions, information about the surface type, and the number of features (e.g., aerosol layers) identified within the column.\r\n\r\nThe CALIPSO satellite comprises three instruments: CALIOP, Imaging Infrared Radiometer (IIR), and Wide Field Camera (WFC). CALIPSO is a joint satellite mission between NASA and the French Agency CNES (Centre National d'Etudes Spatiales).\r\n\r\nCALIPSO was launched on April 28, 2006, to study the impact of clouds and aerosols on the Earth's radiation budget and climate. From June 13, 2006, to September 13, 2018, CALIPSO was part of the A-Train constellation for coincident Earth Observations. After September 13, 2018, the satellite was lowered from 705 to 688 km to resume flying in formation with CloudSat, called the C-Train.",
    "keywords": "NASA, CALIPSO, CALIOP, Cloud, Aerosol",
    "publicationState": "published",
    "dataPublishedTime": "2025-07-31T14:21:48",
    "doiPublishedTime": null,
    "updateFrequency": "",
    "status": "completed",
    "result_field": {
        "ob_id": "https://api.catalogue.ceda.ac.uk/api/v2/observations/43997/?format=api",
        "dataPath": "/neodc/caliop/data/l2_01kmclay/v4-51",
        "oldDataPath": [],
        "storageLocation": "internal",
        "storageStatus": "online",
        "volume": 7228424109344,
        "numberOfFiles": 161830,
        "fileFormat": "Data are HDF4 formatted"
    },
    "timePeriod": "https://api.catalogue.ceda.ac.uk/api/v2/times/12297/?format=api",
    "geographicExtent": "https://api.catalogue.ceda.ac.uk/api/v2/bboxes/1/?format=api",
    "nonGeographicFlag": false,
    "phenomena": [
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/64153/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/64154/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/64159/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/65010/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/65011/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/65012/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/65013/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/65014/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/65015/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/65016/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/65017/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/65018/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/65019/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/65020/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/65021/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/65022/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/65023/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/65025/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/65028/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/65029/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/65037/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/65039/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/65040/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/65041/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/65042/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/65043/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/65048/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/65049/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/65051/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/65086/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/85619/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/85620/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/85621/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/85622/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/85623/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/85624/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/85625/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/85626/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/85627/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/85628/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/85629/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/85630/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/85631/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/85632/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/85633/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/85634/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/85635/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/85636/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/85637/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/85638/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/85639/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/85640/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/85641/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/85642/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/85643/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/85644/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/85645/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/85646/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/85647/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/85648/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/85649/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/85650/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/85651/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/85652/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/85653/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/85654/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/85655/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/85656/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/85657/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/85658/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/85659/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/85660/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/85661/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/85662/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/85663/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/85664/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/85665/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/85666/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/85667/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/85668/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/85669/?format=api"
    ],
    "dataLineage": "These data were obtained from the NASA Langley Research Center Atmospheric Science Data Center and mirrored by CEDA",
    "removedDataTime": null,
    "removedDataReason": "",
    "language": "English",
    "identifier_set": [],
    "projects": [
        "https://api.catalogue.ceda.ac.uk/api/v2/projects/8349/?format=api"
    ],
    "observationcollection_set": [],
    "responsiblepartyinfo_set": [
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/210379/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/210382/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/210381/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/210386/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/210380/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/210383/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/210384/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/210385/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/210387/?format=api"
    ],
    "procedureAcquisition": null,
    "procedureCompositeProcess": "https://api.catalogue.ceda.ac.uk/api/v2/composites/44115/?format=api",
    "procedureComputation": null,
    "permissions": [
        {
            "ob_id": "https://api.catalogue.ceda.ac.uk/api/v2/observations/2559/?format=api",
            "useLimitation": null,
            "accessConstraints": null,
            "accessCategory": "registered",
            "accessRoles": null,
            "label": "registered: None group",
            "licenceURL": "https://eosweb.larc.nasa.gov/citing-asdc-data",
            "licenceClassifications": "any"
        }
    ],
    "discoveryKeywords": []
}