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

404

Authenticated screen has no assignment

409

Stored credential cannot be decrypted with the configured key

503

Presentation Network encryption key is not configured