List current options
Purpose
This endpoint is used to list settings and statuses.
Request data
HTTPS method: GET
- Constants and parameters enclosed in curly brackets { } must be replaced with their values.
- Please see the following Request parameters section with the required and optional parameters tables for their values. The generic request format is as follows.
URL request format
https://{baseURL}/notifications/{versionNumber}/settings?key={Your_API_Key}
URL request example
https://api.tomtom.com/notifications/1/settings?key={Your_API_Key}
curl command request example
curl 'https://api.tomtom.com/notifications/1/settings?key={Your_API_Key}'
Request parameters
The following table describes the parameters that can be used in a request.
- Required parameters must be used or the call will fail.
- Optional parameters may be used.
- The order of request parameters is not important.
Note: There are no optional parameters in this endpoint.
| Required parameters | Description | 
|---|---|
| 
 string | The base URL for calling the API. Value:    | 
| 
 string | Service version. Value:    | 
| 
 string | An API Key valid for the requested service. Value:  Your   | 
Response data
Response body
The following JSON code block demonstrates a successful response from the API server.
1{2 "privacySettings": {3 "deleteAllHistoryMessagesBefore": "ISO8601_timestamp",4 "deleteAllHistoryMessagesBeforeStatus": "<string>"5 }6}
Response fields
The following table describes all of the fields that can appear in a response.
| Primary fields | |
|---|---|
| Field | Description | 
| 
 object | A collection of settings containing information about privacy. | 
| privacySettings object | |
| Field | Description | 
| 
 timestamp | The date before all historical message information will be cleared. If there was no request for the deletion of history, this field will not be presented. Value:    | 
| 
 string | The status of the deletion process. 
 | 
Response codes
| Code | Meaning & possible causes | 
|---|---|
| 
 | OK | 
| 
 | Bad request : Key missing. | 
Example
Request URL
https://api.tomtom.com/notifications/1/settings?key={Your_API_Key}
Response body
1{2 "privacySettings": {3 "deleteAllHistoryMessagesBefore": "2019-07-10T12:30:00.000+00:00",4 "deleteAllHistoryMessagesBeforeStatus": "DELETED"5 }6}