Data subscriptions

Each world has one or more data subscriptions. To get an overview of all data subscriptions in your organization run:

curl "https://nexus.stellaspark.com/api/v1/data_subscriptions/?token={web_api_token}"

It is also possible to filter by feature_type, parameter, and dc_id (data connection id). For example:

curl "https://nexus.stellaspark.com/api/v1/data_subscriptions/?token={web_api_token}&dc_id=223,224"

This returns for example:

[{
        "source": "NWB - wegvakken autowegen",
        "owner": "Rijkswaterstaat",
        "type": "Data source",
        "endpoint": "https://downloads.rijkswaterstaatdata.nl/nwb-wegen/geogegevens/shapefile/Nederland_totaal/",
        "trigger": "Every month on the 2nd Friday at 20:00",
        "sync_last_finished": "2024-08-25T14:31:59Z",
        "sync_next_scheduled": "2024-09-25T14:31:59Z",
        "retention_time": 441504000,
        "dc_id": 223,
        "parent_dc_id": 223,
        "feature_type": "road",
        "n_features": 1560011,
        "oldest_time": "1982-01-01T01:00:00+01:00",
        "newest_time": "2024-08-01T02:00:00+02:00"
    }, {
        "source": "NWB - wegvak kenmerken",
        "owner": "Rijkswaterstaat",
        "type": "Data source",
        "endpoint": "https://downloads.rijkswaterstaatdata.nl/weggeg/geogegevens/shapefile/weggeg_wegvakniveau/",
        "trigger": "Every month on the 2nd Friday at 20:00",
        "sync_last_finished": "2024-08-25T14:31:59Z",
        "sync_next_scheduled": "2024-09-25T14:31:59Z",
        "retention_time": 441504000,
        "dc_id": 224,
        "parent_dc_id": 223,
        "feature_type": "road",
        "n_features": 0,
        "oldest_time": null,
        "newest_time": null
    }
]

Definition of the fields is as described in the table below.

Field	Meaning
source	Name of the data source
owner	Organization owning/maintaining the data source
type	Data subscription type (either 'Data Source' or 'Calculation')
endpoint	Base URL that Nexus uses to harvest the data from
trigger	When a data subscription is synchronized: 'On demand' (new file upload), regular interval (e.g. 'Every day at 18:00'), or 'On input change' (for calculations)
sync_last_finished	Timestamp when the data was last synchronized (harvested or calculated)
sync_next_scheduled	Timestamp when the data will be synchronized next (harvested or calculated)
retention_time	Number of seconds from now that historical data is retained in Nexus cache
dc_id	ID of the data connection with the datasource
parent_dc_id	ID of the data connection to which this data connection is joined
n_features	Number of features
oldest_time	Oldest timestamp found in this dataset (usually of one column, can be oldest of multiple)
newest_time	Newest timestamp found in this dataset (usually of one column, can be newest of multiple)