> For the complete documentation index, see [llms.txt](https://docs.tebex.io/developers/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.tebex.io/developers/headless-api/introduction.md).

# Introduction

The Headless API can retrieve your store's listings, create baskets, and send customers to checkout. It is the same API that backs Tebex-hosted webstores.

Like all Tebex APIs, it is a [RESTful API](http://en.wikipedia.org/wiki/Representational_State_Transfer) that uses JSON-encoded requests and responses. It is documented with [OpenAPI](https://www.openapis.org/), which is used as the foundation for our SDKs and the documentation seen here.

***API Specification:*** [*Tebex Headless OpenAPI Schema*](https://github.com/tebexio/TebexHeadless-OpenAPI/blob/main/headless-api.yaml) 

{% hint style="info" %}
Some endpoints may require prior approval or special account permissions. Please contact our support team if you encounter any issues.
{% endhint %}

## Getting Started

Tebex provides SDKs to streamline your development environment and make API calls. These SDKs contain mappings for all our APIs, not just Headless API.

We recommend using these to avoid writing boilerplate code and to automatically receive updates when the API changes.

{% tabs %}
{% tab title="Node.js" icon="node" %}

```shellscript
npm install tebexio/tebex-sdk-nodejs
```

{% endtab %}

{% tab title="PHP" icon="php" %}

```shellscript
composer require tebex/tebex-sdk-php
```

{% endtab %}

{% tab title="C#" icon="hashtag" %}

```bash
dotnet add package Tebex.CSharp --version 1.1.0
```

{% endtab %}
{% endtabs %}

If we do not have an official SDK in your language, the [OpenAPI generator](https://openapi-generator.tech/) can be used to generate the code to interact with Tebex APIs without starting from scratch.

## Using with Tebex.js

The Headless API can be used with [Tebex.js](/developers/tebex.js/overview.md) for a fully embedded checkout experience without the user ever leaving your own website.

## Examples

These projects use **Headless API** for part or all of their implementation and are open-source.

### Tebex Unity Demo

An in-game store browser UI, basket, and QR-code based checkout in Unity Engine.\
[Tebex for Unity Engine](/developers/tebex-for-unity-engine.md)

<figure><img src="/files/bAeGXpht8ytHRB8H4yjm" alt=""><figcaption></figcaption></figure>

### Hytale Plugin

Hytale is a block-based survival game with a large private server community. Tebex provides an in-game store browser and cart with QR checkout, built on Headless API.

<https://github.com/tebexio/Tebex-Hytale>

<figure><img src="/files/B1VG6SulPHf1LVy94ZtM" alt=""><figcaption></figcaption></figure>