Fetch the assigned network provisioning material

GET

/api/v1/player/presentation-network

const url = 'https://example.com/api/v1/player/presentation-network';
const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

try {
  const response = await fetch(url, options);
  const data = await response.json();
  console.log(data);
} catch (error) {
  console.error(error);
}

curl --request GET \
  --url https://example.com/api/v1/player/presentation-network \
  --header 'Authorization: Bearer <token>'

Device-authenticated only. The server derives the assignment from the authenticated screen and accepts no network ID. The response is marked Cache-Control: no-store and contains the plaintext credential only for the player to build its temporary NetworkManager profile.

Authorizations

deviceBearer

Responses

200

Assigned network and credential; never log or persist this response

application/json

object

data

required

object

presentationNetworkId

required

string format: uuid

name

required

string

ssid

required

string

hidden

required

boolean

security

required

WPA2/WPA3 Personal PSK or WPA2-Enterprise PEAP/MSCHAPv2.

string

Allowed values: wpa_psk wpa_eap_peap_mschapv2

auth

required

object

identity

string

<= 253 characters

anonymousIdentity

string

<= 253 characters

caCertificatePem

Public CA certificate chain for Enterprise server validation.

string

<= 32768 characters

domainSuffixMatch

Expected RADIUS server domain; requires caCertificatePem.

string

<= 253 characters

configRevision

required

integer format: int64

>= 1

profileName

required

string

secret

required

Plaintext credential returned only to the authenticated player over a no-store response.

string format: password

Example

{
  "data": {
    "security": "wpa_psk"
  }
}

Headers

Cache-Control

string

Allowed value: no-store

Pragma

string

Allowed value: no-cache

401

Permanent player credential missing, invalid, or revoked

404

Authenticated screen has no assignment

409

Stored credential cannot be decrypted with the configured key

503

Presentation Network encryption key is not configured