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

/drivekit/admin/beacon/configuration

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

application/json

application/json

application/json

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --url 'https://service.drivequant.com/v3/drivekit/admin/beacon/configuration?proximityuuid=text&major=1&minor=1' \
  --header 'DriveKit-Admin-API-Key: text'

200

401

404

500

200

{
  "pairedStatus": "FREE",
  "user": {
    "id": "text",
    "firstname": "text",
    "lastname": "text"
  },
  "vehicle": {
    "id": "text",
    "name": "text",
    "creationDate": "2025-02-21T18:02:50.647Z",
    "beaconPairingDate": "2025-02-21T18:02:50.647Z",
    "detectionMode": "DISABLED",
    "beaconIdentifier": {
      "proximityUuid": "text",
      "major": 1,
      "minor": 1
    }
  }
}

OK

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