Retrieve site

GET

site

{
  "name": "<string>",
  "url": "https://supertab.co",
  "auth_redirect_uri": "https://signon.supertab.co/auth-proxy",
  "logo_url": "<string>",
  "content_keys": [
    "<string>"
  ],
  "offerings": [
    {
      "id": "offering.cf637646-71a4-430d-aaea-a66f1a48a83c",
      "description": "1 week access to theleek.com",
      "entitlement_details": {
        "duration": "1w"
      },
      "price": {
        "amount": 50,
        "currency": {
          "code": "USD",
          "name": "US Dollar",
          "symbol": "$",
          "base_unit": 100
        }
      },
      "is_pay_now": true
    }
  ],
  "experiences": [
    {
      "id": "experience.cf637646-71a4-430d-aaea-a66f1a48a83c",
      "name": "<string>",
      "type": "basic_paygate",
      "offerings": [
        "offering.4df706b5-297a-49c5-a4cd-2a10eca12ff9"
      ],
      "configuration": {
        "ui_config": {},
        "on_close": "<string>",
        "upsells": [
          {
            "main_offering": "offering.4df706b5-297a-49c5-a4cd-2a10eca12ff9",
            "upsell_offering": "offering.4df706b5-297a-49c5-a4cd-2a10eca12ff9",
            "discount": 123
          }
        ]
      }
    }
  ],
  "test_mode": true
}

Headers

x-api-version

string

default:2025-04-01

Example:

"2025-04-01"

x-supertab-client-id

string

required

Example:

"live_client.4df706b5-297a-49c5-a4cd-2a10eca12ff9"

Response

200

application/json

Successful Response

A site is any website, SaaS product or any other place you deploy Supertab.

It is the top level object in your inventory and contains all offerings.

name

string

required

The name of the site

url

string

required

URL of the site. Supertab will not authenticate customers unless this matches the domain you are serving from.

Minimum length: 1

Example:

"https://supertab.co"

auth_redirect_uri

string

required

Passed to Supertab when authenticating customers on this site

Minimum length: 1

Example:

"https://signon.supertab.co/auth-proxy"

logo_url

string | null

required

The URL of the logo for this site provided to Supertab

Minimum length: 1

content_keys

string[]

required

List of content_keys to use when checking entitlement to your site.

offerings

object[]

required

Offerings are what is available for customers to purchase.

You can define your available offerings in the Supertab Business Portal.

Offerings are what is available for customers to purchase.

You can define your available offerings in the Supertab Business Portal.

offerings.id

string

required

Example:

"offering.cf637646-71a4-430d-aaea-a66f1a48a83c"

offerings.description

string

required

Customer facing name for the offering.

Example:

"1 week access to theleek.com"

offerings.entitlement_details

object | null

required

Specifies the nature and duration of purchased entitlement.

Where you have chosen to have Supertab manage entitlements for you, customer's purchasing such an offering will be granted entitlement to the content associated with the offering for the length of time specified.

Example:

{ "duration": "1w" }

offerings.price

object

required

The price of this offering.

The available price is customer-aware when possible, Supertab restricts some customers to certain currencies depending on their location and prior interactions with Supertab.

offerings.is_pay_now

boolean

required

Offering requires upfront payment, customer will be taken to checkout immediately on purchase.

Used to control Call To Action during purchase confirmation.

experiences

object[]

required

When using Supertab to manage your sales UI, this list of experiences contains the information we use to display an Experience to your customers.

test_mode

boolean

required

See https://docs.supertab.co/supertab-experiences/test-mode

Retrieve current customer Purchase an offering

{
  "name": "<string>",
  "url": "https://supertab.co",
  "auth_redirect_uri": "https://signon.supertab.co/auth-proxy",
  "logo_url": "<string>",
  "content_keys": [
    "<string>"
  ],
  "offerings": [
    {
      "id": "offering.cf637646-71a4-430d-aaea-a66f1a48a83c",
      "description": "1 week access to theleek.com",
      "entitlement_details": {
        "duration": "1w"
      },
      "price": {
        "amount": 50,
        "currency": {
          "code": "USD",
          "name": "US Dollar",
          "symbol": "$",
          "base_unit": 100
        }
      },
      "is_pay_now": true
    }
  ],
  "experiences": [
    {
      "id": "experience.cf637646-71a4-430d-aaea-a66f1a48a83c",
      "name": "<string>",
      "type": "basic_paygate",
      "offerings": [
        "offering.4df706b5-297a-49c5-a4cd-2a10eca12ff9"
      ],
      "configuration": {
        "ui_config": {},
        "on_close": "<string>",
        "upsells": [
          {
            "main_offering": "offering.4df706b5-297a-49c5-a4cd-2a10eca12ff9",
            "upsell_offering": "offering.4df706b5-297a-49c5-a4cd-2a10eca12ff9",
            "discount": 123
          }
        ]
      }
    }
  ],
  "test_mode": true
}

Reference

Guides

Endpoints

Headers

Response