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.

get

/accounts/{token}/categories

Path parameters

tokenstringrequired

The webstore identifier.

Example: t66x-7cd928b1e9312709e6810edac6dc1fd1eefc57cb

Responses

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --url 'https://headless.tebex.io/api/accounts/{token}/categories'

200

200

{
  "data": [
    {
      "id": 2678660,
      "name": "Test",
      "slug": "text",
      "parent": {},
      "description": "text",
      "order": 1,
      "display_type": "list",
      "packages": [
        {
          "id": 6276316,
          "name": "test package 101",
          "description": "<p>this is just a test. only a test. nothing more.</p>",
          "image": null,
          "type": "single",
          "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",
          "category": {
            "id": 2678660,
            "name": "Packages"
          }
        }
      ]
    }
  ]
}

Successful response returns a list of category information.

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

Gets all categories from a webstore including packages.

get

/accounts/{token}/categories?includePackages=1

Path parameters

tokenstringrequired

The webstore identifier.

Example: t66x-7cd928b1e9312709e6810edac6dc1fd1eefc57cb

Responses

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --url 'https://headless.tebex.io/api/accounts/{token}/categories?includePackages=1'

200

200

{
  "data": [
    {
      "id": 2678660,
      "name": "Test",
      "slug": "text",
      "parent": {},
      "description": "text",
      "order": 1,
      "display_type": "list",
      "packages": [
        {
          "id": 6276316,
          "name": "test package 101",
          "description": "<p>this is just a test. only a test. nothing more.</p>",
          "image": null,
          "type": "single",
          "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",
          "category": {
            "id": 2678660,
            "name": "Packages"
          }
        }
      ]
    }
  ]
}

Successful response returns a list of category information.

Gets information about a specific category

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

get

/accounts/{token}/categories/{categoryId}

Path parameters

tokenstringrequired

The webstore identifier.

Example: t66x-7cd928b1e9312709e6810edac6dc1fd1eefc57cb

categoryIdstringrequired

The ID of the category to fetch.

Example: 127244343

Responses

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --url 'https://headless.tebex.io/api/accounts/{token}/categories/{categoryId}'

200

200

{
  "data": [
    {
      "id": 2678660,
      "name": "Test",
      "slug": "text",
      "parent": {},
      "description": "text",
      "order": 1,
      "display_type": "list",
      "packages": [
        {
          "id": 6276316,
          "name": "test package 101",
          "description": "<p>this is just a test. only a test. nothing more.</p>",
          "image": null,
          "type": "single",
          "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",
          "category": {
            "id": 2678660,
            "name": "Packages"
          }
        }
      ]
    }
  ]
}

Successful response returns the category without package information.

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.

get

/accounts/{token}/categories/{categoryId}?includePackages=1

Path parameters

tokenstringrequired

The webstore identifier.

Example: t66x-7cd928b1e9312709e6810edac6dc1fd1eefc57cb

categoryIdstringrequired

The ID of the category to fetch.

Example: 127244343

Responses

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --url 'https://headless.tebex.io/api/accounts/{token}/categories/{categoryId}?includePackages=1'

200

200

{
  "data": [
    {
      "id": 2678660,
      "name": "Test",
      "slug": "text",
      "parent": {},
      "description": "text",
      "order": 1,
      "display_type": "list",
      "packages": [
        {
          "id": 6276316,
          "name": "test package 101",
          "description": "<p>this is just a test. only a test. nothing more.</p>",
          "image": null,
          "type": "single",
          "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",
          "category": {
            "id": 2678660,
            "name": "Packages"
          }
        }
      ]
    }
  ]
}

Successful response returns the category with package information.

Fetch a package from a webstore by its identifier

Gets a package from a webstore by ID.

get

/accounts/{token}/packages/{packageId}

Path parameters

tokenstringrequired

The webstore identifier.

Example: t66x-7cd928b1e9312709e6810edac6dc1fd1eefc57cb

packageIdnumberrequired

The package's ID.

Example: 1272441812

Responses

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --url 'https://headless.tebex.io/api/accounts/{token}/packages/{packageId}'

200

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",
      "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",
      "category": {
        "id": 2678660,
        "name": "Packages"
      }
    }
  ]
}

Successful response returns the package information.

Fetch all packages from a webstore

Gets all packages from a webstore.

get

/accounts/{token}/packages

Path parameters

tokenstringrequired

The webstore identifier.

Example: t66x-7cd928b1e9312709e6810edac6dc1fd1eefc57cb

Responses

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --url 'https://headless.tebex.io/api/accounts/{token}/packages'

200

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",
      "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",
      "category": {
        "id": 2678660,
        "name": "Packages"
      }
    }
  ]
}

Successful response returns a list of package information.

Authenticated Requests

Fetch a package from a webstore by its identifier

Gets all packages from a webstore.

get

/accounts/{token}/packages?ipAddress={ipAddress}

Path parameters

tokenstringrequired

The webstore identifier.

Example: t66x-7cd928b1e9312709e6810edac6dc1fd1eefc57cb

ipAddressstringrequired

An IP address can be provided with authenticated requests.

Example: 127.0.0.1

Responses

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --url 'https://headless.tebex.io/api/accounts/{token}/packages?ipAddress={ipAddress}'

200

422

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",
      "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",
      "category": {
        "id": 2678660,
        "name": "Packages"
      }
    }
  ]
}

Successful response returns a list of package information.

Fetch a package from a webstore by its identifier

Gets all packages from a webstore.

get

/accounts/{token}/packages?ipAddress={ipAddress}&basketIdent={basketIdent}

Path parameters

tokenstringrequired

The webstore identifier.

Example: t66x-7cd928b1e9312709e6810edac6dc1fd1eefc57cb

basketIdentstringrequired

The basket identifier.

Example: c00244-d2ac2e77418a55b25292a6bc7a719ad9c529ba2c

ipAddressstringrequired

An IP address can be provided with authenticated requests.

Example: 127.0.0.1

Responses

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --url 'https://headless.tebex.io/api/accounts/{token}/packages?ipAddress={ipAddress}&basketIdent={basketIdent}'

200

422

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",
      "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",
      "category": {
        "id": 2678660,
        "name": "Packages"
      }
    }
  ]
}

Successful response returns a list of package information.