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

{
    "ob_id": 44002,
    "uuid": "56c26ec4b90e455788e4724d22fd5d92",
    "title": "PyLag particle tracking model of retrospective particles in the North Sea during two contrasting years (2014 and 2017)",
    "abstract": "This dataset uses the PyLag particle tracking model to simulate the ecological connectivity of benthic species in the northern North Sea during two contrasting years (2014 and 2017) to highlight seasonal to annual variability. The particles were released each day and run for 90 days. In the Retrospective Particle Tracks dataset a methodology of releasing an extensive set of particles over a wide area was used. This means the sets of particle tracks can be interrogated to understand connectivity between any two locations in the domain. This could be useful to understand if new human-made structures placed in any locations in the northern North Sea could potentially affect the ecological connectivity or different species with a maturity window up to 90 days. The particle tracks include location, time, age and water temperature. The data were generated under the Natural Environment Research Council (NERC) project CHASANS (Connectivity of Hard Substrate Assemblages in the North Sea) grant reference: NE/T010886/1.",
    "keywords": "",
    "publicationState": "citable",
    "dataPublishedTime": "2025-04-09T15:11:00",
    "doiPublishedTime": "2025-04-09T15:11:00",
    "updateFrequency": "",
    "status": "completed",
    "result_field": {
        "ob_id": "https://api.catalogue.ceda.ac.uk/api/v2/observations/44001/?format=api",
        "dataPath": "/bodc/pol250716",
        "oldDataPath": [],
        "storageLocation": "internal",
        "storageStatus": "online",
        "volume": 15710031960546,
        "numberOfFiles": 732,
        "fileFormat": "NetCDF"
    },
    "timePeriod": "https://api.catalogue.ceda.ac.uk/api/v2/times/12306/?format=api",
    "geographicExtent": "https://api.catalogue.ceda.ac.uk/api/v2/bboxes/4751/?format=api",
    "nonGeographicFlag": false,
    "phenomena": [
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/85514/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/85515/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/85516/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/85517/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/85518/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/85519/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/85520/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/85521/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/85522/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/85523/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/85524/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/85525/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/85526/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/85527/?format=api"
    ],
    "dataLineage": "The data are archived on the British Oceanographic Data Centre (BODC)'s space at the Centre for Environmental Data Analysis (CEDA) and assigned a DOI. No quality control procedures were applied by BODC.",
    "removedDataTime": null,
    "removedDataReason": "",
    "language": "English",
    "identifier_set": [
        "https://api.catalogue.ceda.ac.uk/api/v2/identifiers/13298/?format=api"
    ],
    "projects": [],
    "observationcollection_set": [],
    "responsiblepartyinfo_set": [
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/210410/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/210412/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/210411/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/210409/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/210408/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/210407/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/210413/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/210414/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/210415/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/210416/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/210417/?format=api"
    ],
    "procedureAcquisition": null,
    "procedureCompositeProcess": null,
    "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": []
}