Get a configuration by its identifier
This endpoint fetches and returns a specific configuration's details. The configuration ID parameter, which was provided when the configuration was created through the POST request, is need to retrieve the configuration details.
Note: The user needs to authenticate with their ThingSpace credentials using the Access/Bearer and Session/M2M tokens in order to call this API.
Authorization
thingspace_oauth sessionToken This is the ThingSpace token, from Credentials and Tokens is used
In: header
This is the Session/M2M token needed to authenticate the user. It should be acquired by using the ThingSpace APIs. For detail on how to obtain a Session/M2M token please refer to the
- ThingSpace Quick Start Guide - Obtaining a VZ-M2M Session Token Programmatically
- or the ThingSpace API Video Guide 1 and ThingSpace API Video Guide 2
In: header
Query Parameters
The configuration identifier
^[0-9a-fA-F]{8}-?[0-9a-fA-F]{4}-?4[0-9a-fA-F]{3}-?[89abAB][0-9a-fA-F]{3}-?[0-9a-fA-F]{12}$32 <= length <= 36Header Parameters
The vendor's identifier
^[a-zA-Z0-9]+$1 <= length <= 64Response Body
application/json
application/json
application/json
application/json
application/json
curl -X GET "https://example.com/api/v1/application/configurations/geofence?id=18bac1ff-c7bd-44d9-a7ad-06a093a94713" \ -H "VendorID: VerizonETX"{ "id": "a4fcd16a-343d-4527-8203-2f46e3e4ff4b", "vendorId": "VerizonETX", "name": "string", "description": "string", "geoFence": { "type": "FeatureCollection", "features": [ { "type": "Feature", "geometry": { "type": "LineString", "coordinates": [ [ -180 ], [ -180 ] ] }, "properties": {} } ] }, "messageStandard": "etsi", "messages": [ { "isPrivate": true, "roadUserType": [ "VulnerableRoadUser" ], "triggerConditions": [ "enter" ], "limits": [ { "speed": null } ], "distributionType": [ "Targeted" ], "distributionSchedule": { "repeatPeriod": 5, "duration": 1, "startTime": "2042-07-21T17:32:28Z" }, "generic": { "messageType": "string", "messageFormat": "string", "payload": "string" } } ], "isActive": true}Get all configurations by VendorID GET
This endpoint fetches and returns the list of configurations defined by the Vendor. The list contains the configurations' identifier, name, description, and active flag. The vendor ID is provided when the configuration is created through the POST request. Note: The user needs to authenticate with their ThingSpace credentials using the Access/Bearer and Session/M2M tokens in order to call this API.
Create a configuration POST
This endpoint creates a new configuration in the system. The data for the new configuration should be provided as JSON in the body of the POST request. The system will return with a unique ID for the configuration, which is needed for any further manipulation (update or delete) of the configuration. Note: The user needs to authenticate with their ThingSpace credentials using the Access/Bearer and Session/M2M tokens in order to call this API.

