Get an agency's plans and its active automatic offers
Returns the plans a merchant can subscribe to under the calling agency, with the agency’s active automatic offers. Call it from the agency’s own signup or pricing page to show current prices and any running campaign without a rebuild.
No API key. The agency is resolved from the Origin or Referer of the browser call (the host maps to exactly one agency),
or from the x-agency-signup-key header for a server-side call. A request that resolves to no agency receives the same
404 not_found answer whatever the reason.
What is returned. plans lists the agency’s visible tiers (or the platform plans when the agency’s merchants are billed by the
platform, in which case billed_by is platform and offers is empty). offers lists active offers that apply automatically:
each carries the discount, how long it lasts, its window, and for every plan and billing period the price, the discount and the
final price. Offers that need a code are never listed.
Money. Every amount is a decimal in major units of the plan currency (12.50).
Caching. The answer may be cached for up to a minute. Rate limited per caller address.
curl --request GET \
--url https://api.tybritelabs.com/v1/agency/pricingimport requests
url = "https://api.tybritelabs.com/v1/agency/pricing"
response = requests.get(url)
print(response.text)const options = {method: 'GET'};
fetch('https://api.tybritelabs.com/v1/agency/pricing', 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.tybritelabs.com/v1/agency/pricing",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
]);
$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.tybritelabs.com/v1/agency/pricing"
req, _ := http.NewRequest("GET", url, nil)
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.tybritelabs.com/v1/agency/pricing")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.tybritelabs.com/v1/agency/pricing")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
response = http.request(request)
puts response.read_body{
"billed_by": "agency",
"plans": [
{
"slug": "gold",
"name": "Gold",
"currency": "USD",
"monthly": 123,
"annual": 1230
}
],
"offers": [
{
"id": "5b0c1c0e-9d7e-4a53-8f6b-2f1d9b6a7c11",
"title": "Black November",
"discount": {
"type": "percent",
"percent_off": 20
},
"duration": {
"mode": "first_period",
"periods": 1
},
"starts_at": null,
"ends_at": "2026-11-30T23:59:59Z",
"prices": [
{
"plan": "gold",
"period": "annual",
"price": 1230,
"discount": 246,
"final": 984
}
]
}
]
}{
"error": {
"code": "invalid_request",
"message": "Missing required field",
"details": "The 'email' field is required",
"hint": "<string>",
"available_stock": 123,
"current_cart_quantity": 123,
"limit": 123,
"remaining": 123,
"reset": 123
}
}{
"error": {
"code": "invalid_request",
"message": "Missing required field",
"details": "The 'email' field is required",
"hint": "<string>",
"available_stock": 123,
"current_cart_quantity": 123,
"limit": 123,
"remaining": 123,
"reset": 123
}
}{
"error": {
"code": "invalid_request",
"message": "Missing required field",
"details": "The 'email' field is required",
"hint": "<string>",
"available_stock": 123,
"current_cart_quantity": 123,
"limit": 123,
"remaining": 123,
"reset": 123
}
}Headers
curl --request GET \
--url https://api.tybritelabs.com/v1/agency/pricingimport requests
url = "https://api.tybritelabs.com/v1/agency/pricing"
response = requests.get(url)
print(response.text)const options = {method: 'GET'};
fetch('https://api.tybritelabs.com/v1/agency/pricing', 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.tybritelabs.com/v1/agency/pricing",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
]);
$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.tybritelabs.com/v1/agency/pricing"
req, _ := http.NewRequest("GET", url, nil)
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.tybritelabs.com/v1/agency/pricing")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.tybritelabs.com/v1/agency/pricing")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
response = http.request(request)
puts response.read_body{
"billed_by": "agency",
"plans": [
{
"slug": "gold",
"name": "Gold",
"currency": "USD",
"monthly": 123,
"annual": 1230
}
],
"offers": [
{
"id": "5b0c1c0e-9d7e-4a53-8f6b-2f1d9b6a7c11",
"title": "Black November",
"discount": {
"type": "percent",
"percent_off": 20
},
"duration": {
"mode": "first_period",
"periods": 1
},
"starts_at": null,
"ends_at": "2026-11-30T23:59:59Z",
"prices": [
{
"plan": "gold",
"period": "annual",
"price": 1230,
"discount": 246,
"final": 984
}
]
}
]
}{
"error": {
"code": "invalid_request",
"message": "Missing required field",
"details": "The 'email' field is required",
"hint": "<string>",
"available_stock": 123,
"current_cart_quantity": 123,
"limit": 123,
"remaining": 123,
"reset": 123
}
}{
"error": {
"code": "invalid_request",
"message": "Missing required field",
"details": "The 'email' field is required",
"hint": "<string>",
"available_stock": 123,
"current_cart_quantity": 123,
"limit": 123,
"remaining": 123,
"reset": 123
}
}{
"error": {
"code": "invalid_request",
"message": "Missing required field",
"details": "The 'email' field is required",
"hint": "<string>",
"available_stock": 123,
"current_cart_quantity": 123,
"limit": 123,
"remaining": 123,
"reset": 123
}
}
