Access tiers
List access tiers
Lists access tiers configured for a project.
GET
/
projects
/
{project_id}
/
player_settings
/
access_tiers
List access tiers
curl --request GET \
--url https://api.beyondwords.io/v1/projects/{project_id}/player_settings/access_tiers \
--header 'X-Api-Key: <api-key>'import requests
url = "https://api.beyondwords.io/v1/projects/{project_id}/player_settings/access_tiers"
headers = {"X-Api-Key": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {'X-Api-Key': '<api-key>'}};
fetch('https://api.beyondwords.io/v1/projects/{project_id}/player_settings/access_tiers', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.beyondwords.io/v1/projects/{project_id}/player_settings/access_tiers",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"X-Api-Key: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.beyondwords.io/v1/projects/{project_id}/player_settings/access_tiers"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("X-Api-Key", "<api-key>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.beyondwords.io/v1/projects/{project_id}/player_settings/access_tiers")
.header("X-Api-Key", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.beyondwords.io/v1/projects/{project_id}/player_settings/access_tiers")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["X-Api-Key"] = '<api-key>'
response = http.request(request)
puts response.read_body[
{
"id": 1,
"slug": "anonymous",
"name": "anonymous",
"segment_limit": null,
"ads_enabled": true,
"intro_url": null,
"outro_url": null
},
{
"id": 2,
"slug": "registered",
"name": "registered",
"segment_limit": null,
"ads_enabled": true,
"intro_url": null,
"outro_url": null
},
{
"id": 3,
"slug": "subscribed",
"name": "subscribed",
"segment_limit": null,
"ads_enabled": false,
"intro_url": null,
"outro_url": null
}
]Authorizations
Path Parameters
The numeric ID of your project
Response
200 - application/json
OK
Unique identifier for the object
Human readable name of the access tier
Maximum number of segments allowed for playback. Null means no limit.
Whether ads are enabled for this tier
URL of the intro audio file
URL of the outro audio file
Time at which the object was created (ISO 8601)
Time at which the object was updated (ISO 8601)
Was this page helpful?
Previous
Create access tierCreates an access tier for a project to control player access to content.
Next
⌘I
List access tiers
curl --request GET \
--url https://api.beyondwords.io/v1/projects/{project_id}/player_settings/access_tiers \
--header 'X-Api-Key: <api-key>'import requests
url = "https://api.beyondwords.io/v1/projects/{project_id}/player_settings/access_tiers"
headers = {"X-Api-Key": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {'X-Api-Key': '<api-key>'}};
fetch('https://api.beyondwords.io/v1/projects/{project_id}/player_settings/access_tiers', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.beyondwords.io/v1/projects/{project_id}/player_settings/access_tiers",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"X-Api-Key: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.beyondwords.io/v1/projects/{project_id}/player_settings/access_tiers"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("X-Api-Key", "<api-key>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.beyondwords.io/v1/projects/{project_id}/player_settings/access_tiers")
.header("X-Api-Key", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.beyondwords.io/v1/projects/{project_id}/player_settings/access_tiers")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["X-Api-Key"] = '<api-key>'
response = http.request(request)
puts response.read_body[
{
"id": 1,
"slug": "anonymous",
"name": "anonymous",
"segment_limit": null,
"ads_enabled": true,
"intro_url": null,
"outro_url": null
},
{
"id": 2,
"slug": "registered",
"name": "registered",
"segment_limit": null,
"ads_enabled": true,
"intro_url": null,
"outro_url": null
},
{
"id": 3,
"slug": "subscribed",
"name": "subscribed",
"segment_limit": null,
"ads_enabled": false,
"intro_url": null,
"outro_url": null
}
]