Getting Your Listings

You can retrieve your packages & category listings in JSON format and display them however you wish.

Gets all categories available in the webstore.

Gets all categories from a webstore. This does not include package information. To include package information, add ?includePackages=1 to the URL.

GEThttps://headless.tebex.io/api/accounts/{token}/categories

Path parameters

token*string

The webstore identifier.

Example: "t66x-7cd928b1e9312709e6810edac6dc1fd1eefc57cb"

Response

200

Successful response returns a list of category information.

Body

application/json

dataarray of Category (object)

Request

JavaScriptCurlPython

const response = await fetch('https://headless.tebex.io/api/accounts/{token}/categories', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

Response

200

{
  "data": [
    {
      "id": 2678660,
      "name": "Test",
      "slug": "text",
      "description": "text",
      "packages": [
        {
          "id": 6276316,
          "name": "test package 101",
          "description": "<p>this is just a test. only a test. nothing more.</p>",
          "image": null,
          "type": "single",
          "category": {
            "id": 2678660,
            "name": "Packages"
          },
          "base_price": 5,
          "sales_tax": 0,
          "total_price": 5,
          "currency": "USD",
          "discount": 0,
          "disable_quantity": false,
          "disable_gifting": false,
          "expiration_date": null,
          "created_at": "2024-05-21T18:09:17+00:00",
          "updated_at": "2024-05-21T18:09:17+00:00"
        }
      ],
      "order": 1,
      "display_type": "list"
    }
  ]
}

Gets a store's categories including all package information with them.

Gets all categories from a webstore including packages.

GEThttps://headless.tebex.io/api/accounts/{token}/categories?includePackages=1

Path parameters

token*string

The webstore identifier.

Example: "t66x-7cd928b1e9312709e6810edac6dc1fd1eefc57cb"

Response

200

Successful response returns a list of category information.

Body

application/json

dataarray of Category (object)

Request

JavaScriptCurlPython

const response = await fetch('https://headless.tebex.io/api/accounts/{token}/categories?includePackages=1', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

Response

200

{
  "data": [
    {
      "id": 2678660,
      "name": "Test",
      "slug": "text",
      "description": "text",
      "packages": [
        {
          "id": 6276316,
          "name": "test package 101",
          "description": "<p>this is just a test. only a test. nothing more.</p>",
          "image": null,
          "type": "single",
          "category": {
            "id": 2678660,
            "name": "Packages"
          },
          "base_price": 5,
          "sales_tax": 0,
          "total_price": 5,
          "currency": "USD",
          "discount": 0,
          "disable_quantity": false,
          "disable_gifting": false,
          "expiration_date": null,
          "created_at": "2024-05-21T18:09:17+00:00",
          "updated_at": "2024-05-21T18:09:17+00:00"
        }
      ],
      "order": 1,
      "display_type": "list"
    }
  ]
}

Gets information about a specific category

Gets information about a category and returns the packages in that category.

GEThttps://headless.tebex.io/api/accounts/{token}/categories/{categoryId}

Path parameters

token*string

The webstore identifier.

Example: "t66x-7cd928b1e9312709e6810edac6dc1fd1eefc57cb"

categoryId*string

The ID of the category to fetch.

Example: 127244343

Response

200

Successful response returns the category without package information.

Body

application/json

dataarray of Category (object)

Request

JavaScriptCurlPython

const response = await fetch('https://headless.tebex.io/api/accounts/{token}/categories/{categoryId}', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

Response

200

{
  "data": [
    {
      "id": 2678660,
      "name": "Test",
      "slug": "text",
      "description": "text",
      "packages": [
        {
          "id": 6276316,
          "name": "test package 101",
          "description": "<p>this is just a test. only a test. nothing more.</p>",
          "image": null,
          "type": "single",
          "category": {
            "id": 2678660,
            "name": "Packages"
          },
          "base_price": 5,
          "sales_tax": 0,
          "total_price": 5,
          "currency": "USD",
          "discount": 0,
          "disable_quantity": false,
          "disable_gifting": false,
          "expiration_date": null,
          "created_at": "2024-05-21T18:09:17+00:00",
          "updated_at": "2024-05-21T18:09:17+00:00"
        }
      ],
      "order": 1,
      "display_type": "list"
    }
  ]
}

Gets information about a specific category, including all the packages in the category

Gets information about a category and returns the packages in that category.

GEThttps://headless.tebex.io/api/accounts/{token}/categories/{categoryId}?includePackages=1

Path parameters

token*string

The webstore identifier.

Example: "t66x-7cd928b1e9312709e6810edac6dc1fd1eefc57cb"

categoryId*string

The ID of the category to fetch.

Example: 127244343

Response

200

Successful response returns the category with package information.

Body

application/json

dataarray of Category (object)

Request

JavaScriptCurlPython

const response = await fetch('https://headless.tebex.io/api/accounts/{token}/categories/{categoryId}?includePackages=1', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

Response

200

{
  "data": [
    {
      "id": 2678660,
      "name": "Test",
      "slug": "text",
      "description": "text",
      "packages": [
        {
          "id": 6276316,
          "name": "test package 101",
          "description": "<p>this is just a test. only a test. nothing more.</p>",
          "image": null,
          "type": "single",
          "category": {
            "id": 2678660,
            "name": "Packages"
          },
          "base_price": 5,
          "sales_tax": 0,
          "total_price": 5,
          "currency": "USD",
          "discount": 0,
          "disable_quantity": false,
          "disable_gifting": false,
          "expiration_date": null,
          "created_at": "2024-05-21T18:09:17+00:00",
          "updated_at": "2024-05-21T18:09:17+00:00"
        }
      ],
      "order": 1,
      "display_type": "list"
    }
  ]
}

Fetch a package from a webstore by its identifier

Gets a package from a webstore by ID.

GEThttps://headless.tebex.io/api/accounts/{token}/packages/{packageId}

Path parameters

token*string

The webstore identifier.

Example: "t66x-7cd928b1e9312709e6810edac6dc1fd1eefc57cb"

packageId*number

The package's ID.

Example: 1272441812

Response

200

Successful response returns the package information.

Body

application/json

dataarray of Package (object)

Request

JavaScriptCurlPython

const response = await fetch('https://headless.tebex.io/api/accounts/{token}/packages/{packageId}', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

Response

200

{
  "data": [
    {
      "id": 6276316,
      "name": "test package 101",
      "description": "<p>this is just a test. only a test. nothing more.</p>",
      "image": null,
      "type": "single",
      "category": {
        "id": 2678660,
        "name": "Packages"
      },
      "base_price": 5,
      "sales_tax": 0,
      "total_price": 5,
      "currency": "USD",
      "discount": 0,
      "disable_quantity": false,
      "disable_gifting": false,
      "expiration_date": null,
      "created_at": "2024-05-21T18:09:17+00:00",
      "updated_at": "2024-05-21T18:09:17+00:00"
    }
  ]
}

Fetch all packages from a webstore

Gets all packages from a webstore.

GEThttps://headless.tebex.io/api/accounts/{token}/packages

Path parameters

token*string

The webstore identifier.

Example: "t66x-7cd928b1e9312709e6810edac6dc1fd1eefc57cb"

Response

200

Successful response returns a list of package information.

Body

application/json

dataarray of Package (object)

Request

JavaScriptCurlPython

const response = await fetch('https://headless.tebex.io/api/accounts/{token}/packages', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

Response

200

{
  "data": [
    {
      "id": 6276316,
      "name": "test package 101",
      "description": "<p>this is just a test. only a test. nothing more.</p>",
      "image": null,
      "type": "single",
      "category": {
        "id": 2678660,
        "name": "Packages"
      },
      "base_price": 5,
      "sales_tax": 0,
      "total_price": 5,
      "currency": "USD",
      "discount": 0,
      "disable_quantity": false,
      "disable_gifting": false,
      "expiration_date": null,
      "created_at": "2024-05-21T18:09:17+00:00",
      "updated_at": "2024-05-21T18:09:17+00:00"
    }
  ]
}

Authenticated Requests

Fetch a package from a webstore by its identifier

Gets all packages from a webstore.

GEThttps://headless.tebex.io/api/accounts/{token}/packages?ipAddress={ipAddress}

Path parameters

token*string

The webstore identifier.

Example: "t66x-7cd928b1e9312709e6810edac6dc1fd1eefc57cb"

ipAddress*string

An IP address can be provided with authenticated requests.

Example: "127.0.0.1"

Response

200422

Successful response returns a list of package information.

Body

application/json

dataarray of Package (object)

Request

JavaScriptCurlPython

const response = await fetch('https://headless.tebex.io/api/accounts/{token}/packages?ipAddress={ipAddress}', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

Response

200

{
  "data": [
    {
      "id": 6276316,
      "name": "test package 101",
      "description": "<p>this is just a test. only a test. nothing more.</p>",
      "image": null,
      "type": "single",
      "category": {
        "id": 2678660,
        "name": "Packages"
      },
      "base_price": 5,
      "sales_tax": 0,
      "total_price": 5,
      "currency": "USD",
      "discount": 0,
      "disable_quantity": false,
      "disable_gifting": false,
      "expiration_date": null,
      "created_at": "2024-05-21T18:09:17+00:00",
      "updated_at": "2024-05-21T18:09:17+00:00"
    }
  ]
}

Fetch a package from a webstore by its identifier

Gets all packages from a webstore.

GEThttps://headless.tebex.io/api/accounts/{token}/packages?ipAddress={ipAddress}&basketIdent={basketIdent}

Path parameters

token*string

The webstore identifier.

Example: "t66x-7cd928b1e9312709e6810edac6dc1fd1eefc57cb"

basketIdent*string

The basket identifier.

Example: "c00244-d2ac2e77418a55b25292a6bc7a719ad9c529ba2c"

ipAddress*string

An IP address can be provided with authenticated requests.

Example: "127.0.0.1"

Response

200422

Successful response returns a list of package information.

Body

application/json

dataarray of Package (object)

Request

JavaScriptCurlPython

const response = await fetch('https://headless.tebex.io/api/accounts/{token}/packages?ipAddress={ipAddress}&basketIdent={basketIdent}', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

Response

200

{
  "data": [
    {
      "id": 6276316,
      "name": "test package 101",
      "description": "<p>this is just a test. only a test. nothing more.</p>",
      "image": null,
      "type": "single",
      "category": {
        "id": 2678660,
        "name": "Packages"
      },
      "base_price": 5,
      "sales_tax": 0,
      "total_price": 5,
      "currency": "USD",
      "discount": 0,
      "disable_quantity": false,
      "disable_gifting": false,
      "expiration_date": null,
      "created_at": "2024-05-21T18:09:17+00:00",
      "updated_at": "2024-05-21T18:09:17+00:00"
    }
  ]
}