Configuration

This service provides beacon configuration information based on its identifiers

• Beacon status (paired, available)

• Vehicle to which beacon is paired

  • Vehicle's unique identifier

  • Name

  • Detection mode (BEACON)

  • Creation date

  • Beacon identifiers

  • Beacon pairing date

• Identifiers of the vehicle's owner (id, firstname, lastname).

If you have your admin API key, you can try the API via this link.

Get a beacon's configuration

get

Query parameters

proximityuuidstringRequired

Beacon proximity uuid

majorintegerRequired

Beacon major value

minorintegerRequired

Beacon minor value

Header parameters

DriveKit-Admin-API-KeystringRequired

DriveKit Admin API key

Responses

200

OK

application/json

401

Invalid API Key

application/json

404

Beacon Not Found

application/json

500

Failed to retrieve vehicle configuration

application/json

get

HTTPcURLJavaScriptPython

GET /v3/drivekit/admin/beacon/configuration HTTP/1.1
Host: service.drivequant.com
DriveKit-Admin-API-Key: text
Accept: */*

{
  "pairedStatus": "FREE",
  "vehicle": {
    "id": "text",
    "name": "text",
    "detectionMode": "DISABLED",
    "creationDate": "2025-05-09T05:58:43.577Z",
    "beaconIdentifier": {
      "proximityUuid": "text",
      "major": 1,
      "minor": 1
    },
    "beaconPairingDate": "2025-05-09T05:58:43.577Z"
  },
  "user": {
    "id": "text",
    "firstname": "text",
    "lastname": "text"
  }
}

Parameters

The table below summarizes the list of query parameters.

Field	Type	Description	Required ?
proximityuuid	string	Beacon proximity UUID	yes
major	int	Beacon major	yes
minor	int	Beacon minor	yes

Response

The table below summarizes the list of beacon configuration parameters.

Field	Type	Description
pairedStatus	string	Beacon paired status Allowed values: PAIRED, FREE
vehicle	Vehicle	Vehicle paired to the beacon (null if the beacon is not paired)
user	User	User informations

Vehicle

Field	Type	Description
id	string	Vehicle unique identifier
name	string	Vehicle name
detectionMode	string	Detection mode Allowed values: DISABLED, GPS, BEACON, BLUETOOTH
creationDate	date	Creation date Date format: YYYY-MM-dd’T’HH:mm:ss.SSSZ
beaconIdentifier	BeaconIdentifier	Beacon paired to the vehicle
beaconPairingDate	date	Beacon pairing date

BeaconIdentifier

Field	Type	Description
proximityUuid	string	Beacon proximity UUID
major	int	Beacon major
minor	int	Beacon minor

User

Field	Type	Description
id	string	User unique identifier
firstname	string	User firstname
lastname	string	User lastname