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

{
    "ob_id": 45233,
    "uuid": "cd037a9ea387438fabf4d674dbe53088",
    "title": "Mars Analysis Correction Data Assimilation (MACDA): Atmospheric and surface fields produced from assimilated MGS/TES, ODY/THEMIS, and MRO/MCS observations, v2.0",
    "abstract": "This dataset contains 268 files of basic gridded atmospheric and surface data for the planet Mars, each covering a period of 30 sols (Martian mean solar days). The fields are produced by assimilating retrieved atmospheric quantities using the Analysis Correction (AC) scheme in the UK spectral version (Oxford University and The Open University) of the Mars Planetary Climate Model (Mars-PCM), which is maintained by the Laboratoire de Météorologie Dynamique at Sorbonne Université in Paris, France. \r\n\r\nObservations are taken from the Mars Global Surveyor/Thermal Emission Spectrometer (MGS/TES), the Mars Odyssey/Thermal Emission Imaging System (ODY/THEMIS), and the Mars Reconnaissance Orbiter/Mars Climate Sounder (MRO/MCS) instruments. Assimilated MGS/TES retrievals include nadir thermal profiles below approximately 40 km altitude and column dust optical depth values. Assimilated ODY/THEMIS retrievals include column dust optical depth values. Assimilated MRO/MCS retrievals include limb thermal profiles and dust extinction profiles below approximately 80 km altitude, as well as estimates of column dust optical depth values.\r\n\r\nThe dataset covers 12 Martian years (MY), from MY 24 through MY 35 (i.e. from July 1998 through February 2021). Each file contains 30 sols, and each sol contains variables at 12 times. TES, THEMIS, and MCS retrievals are assimilated separately, with no overlap. Several 30-sol periods at the beginning of MY 24 contain no available observations; in these cases the model is run with no assimilation (free run).\r\n\r\nThe file name and the \"assimilation_run_type\" global attribute indicate which observing system is assimilated in each file: MGS/TES, ODY/THEMIS, MRO/MCS, MRO/MCS_nodust (only thermal profiles, no dust extinction profiles nor column dust optical depth values), MRO/MCS_nodustprof (only thermal profiles and column dust optical depth values, no dust extinction profiles), or free-run (i.e. no assimilated observations because retrievals are not available).",
    "keywords": "Mars, Martian, MGCM, dust, dust and temperature assimilation",
    "publicationState": "citable",
    "dataPublishedTime": "2026-01-30T09:22:14",
    "doiPublishedTime": "2026-01-30T13:55:11.727434",
    "updateFrequency": "notPlanned",
    "status": "completed",
    "result_field": {
        "ob_id": "https://api.catalogue.ceda.ac.uk/api/v2/observations/45228/?format=api",
        "dataPath": "/badc/mgs/data/macda/v2-0",
        "oldDataPath": [],
        "storageLocation": "internal",
        "storageStatus": "online",
        "volume": 216084277205,
        "numberOfFiles": 269,
        "fileFormat": "Data are NetCDF formatted"
    },
    "timePeriod": "https://api.catalogue.ceda.ac.uk/api/v2/times/12889/?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/50559/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/50561/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/60438/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/92745/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/92746/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/92747/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/92748/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/92749/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/92750/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/92751/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/92753/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/92755/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/92756/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/92757/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/92758/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/92759/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/92760/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/92761/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/92762/?format=api"
    ],
    "dataLineage": "The atmospheric and surface data included in this dataset are produced by assimilating retrieved atmospheric quantities using the Analysis Correction (AC) scheme in the UK spectral version (Oxford University and The Open University) of the Mars Planetary Climate Model (Mars-PCM), which is maintained by the Laboratoire de Météorologie Dynamique at Sorbonne Université in Paris, France. The model version used is labelled Mars_PCM-UK-spectral_v5.2. This dataset represents version 2 of the MACDA project and assimilates retrievals from observations by the Mars Global Surveyor/Thermal Emission Spectrometer (MGS/TES), the Mars Odyssey/Thermal Emission Imaging System (ODY/THEMIS), and the Mars Reconnaissance Orbiter/Mars Climate Sounder (MRO/MCS) instruments. TES column dust optical depth retrievals are version 2023 (http://doi.org/10.17189/kwez-jq47) and MCS retrievals are version 5.2.\r\n\r\n\r\nData produced by the project team were then supplied for archiving at the Centre for Environmental Data Analysis (CEDA).",
    "removedDataTime": null,
    "removedDataReason": "",
    "language": "English",
    "identifier_set": [
        "https://api.catalogue.ceda.ac.uk/api/v2/identifiers/13696/?format=api"
    ],
    "projects": [
        "https://api.catalogue.ceda.ac.uk/api/v2/projects/11610/?format=api"
    ],
    "observationcollection_set": [
        "https://api.catalogue.ceda.ac.uk/api/v2/observationcollections/11018/?format=api"
    ],
    "responsiblepartyinfo_set": [
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/216446/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/216437/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/216438/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/216439/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/216440/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/216441/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/216442/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/216436/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/216443/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/216444/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/216445/?format=api"
    ],
    "procedureAcquisition": null,
    "procedureCompositeProcess": "https://api.catalogue.ceda.ac.uk/api/v2/composites/45235/?format=api",
    "procedureComputation": null,
    "permissions": [
        {
            "ob_id": "https://api.catalogue.ceda.ac.uk/api/v2/observations/2526/?format=api",
            "useLimitation": null,
            "accessConstraints": null,
            "accessCategory": "public",
            "accessRoles": null,
            "label": "public: None group",
            "licenceURL": "http://www.nationalarchives.gov.uk/doc/open-government-licence/version/3/",
            "licenceClassifications": "any"
        }
    ],
    "discoveryKeywords": [
        {
            "ob_id": 1138,
            "name": "NDGO0003"
        }
    ]
}