With this API call the user can check the certificate of the device. At least one of the DeviceID, IMEI, ICCID or IMSI is required to make the call.
Note: The user needs to authenticate with their ThingSpace credentials using the Access/Bearer and Session/M2M tokens in order to call this API.
thingspace_oauth sessionToken Access/Bearer token needed to authorize the user. The Bearer/Access Token should be acquired by using the ThingSpace Portal (thingspace.verizon.com). For details on how to obtain the token please refer to the
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
In: header
One of the following IDs is required- DeviceID, IMEI, ICCID, IMSI. If more than one ID is provided, the API will return the certificate for the first ID found. The IDs are evaluated in the following order: DeviceID, IMEI, ICCID, IMSI. If the first provided ID is not found, the API will return an error.
The VendorID set during the Vendor registration call.
^[a-zA-Z0-9]+$length <= 64Optional transaction identifier for tracing requests. If not provided, the application will generate one.
^[0-9A-Fa-f]{8}-[0-9A-Fa-f]{4}-[0-9A-Fa-f]{4}-[0-9A-Fa-f]{4}-[0-9A-Fa-f]{12}$uuid36 <= length <= 36application/json
application/json
application/json
application/json
application/json
application/json
application/json
application/json
curl -X GET "https://example.com/api/v2/clients/registration?DeviceID=a4fcd16a-343d-4527-8203-2f46e3e4ff4b&IMEI=12-345678-901234-5&ICCID=89345678901234567890&IMSI=123456789012345" \ -H "VendorID: VerizonETX"{ "DeviceID": "a4fcd16a-343d-4527-8203-2f46e3e4ff4b", "Certificate": { "cert.pem": "\"-----BEGIN CERTIFICATE-----\nMIIDrjCCApagAwIBAgICEAEwDQYJKoZIhvcNAQELBQAwUjELMAkGA1UEBhMCQVUx\n...\nuuA1Zog3aBOeeEzp9SEJBMTJRYPXbK4e8Xer+7m98OL/3g==\n-----END CERTIFICATE-----\"\n", "key.pem": "\"-----BEGIN PRIVATE KEY-----\nMIIEvgIBADANBgkqhkiG9w0BAQEFAASCBKgwggSkAgEAAoIBAQDa1lF7DWudshQ5\n...\nJbjD2hacWGzpKzTfn5Mt1frE\n-----END PRIVATE KEY-----\"\n", "ca.pem": "\"-----BEGIN CERTIFICATE-----\nMIIEvgIBADANBgkqhkiG9w0BAQEFAASCBKgwggSkAgEAAoIBAQDa1lF7DWudshQ5\n...\nJbjD2hacWGzpKzTfn5Mt1frE\n-----END CERTIFICATE-----\"\n", "ExpirationTime": "2017-07-21T17:32:28Z" }, "ClientType": "Vehicle", "ClientSubtype": "PassengerCar", "VendorID": "VerizonETX"}{ "error": "Error Summary", "description": "Error Description"}{ "error": "Error Summary", "description": "Error Description"}{ "error": "Error Summary", "description": "Error Description"}{ "error": "Error Summary", "description": "Error Description"}{ "error": "Error Summary", "description": "Error Description"}{ "error": "Error Summary", "description": "Error Description"}{ "error": "Error Summary", "description": "Error Description"}