> ## Documentation Index
> Fetch the complete documentation index at: https://docs.smatvirtual.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Introduction

> Technical specifications for smatvirtual's core integration endpoints.

## Overview

The **smatvirtual** API is organized around REST. All requests are made to our Unified Gateway, which handles game discovery, account management, and secure session generation.

Our API has predictable resource-oriented URLs, accepts form-encoded/JSON request bodies, and returns JSON-encoded responses with standard HTTP response codes.

## Core Endpoints

To get your platform live, you only need to interact with these three primary endpoints:

<CardGroup cols={3}>
  <Card title="Merchant Account" icon="user-plus" href="/api-reference/create-merchant">
    Create and configure your merchant identity.
  </Card>

  <Card title="Get Games" icon="slot-machine" href="/api-reference/get-games">
    Fetch the list of Instant and Tournament titles.
  </Card>

  <Card title="Launch URL" icon="rocket" href="/api-reference/launch-url">
    Generate secure links to start player sessions.
  </Card>
</CardGroup>

## Authentication

Unlike standard Bearer tokens, **smatvirtual** uses a custom header for all requests. You must include your concatenated API key in every call to identify your merchant and operator environment.

| Header Key   | Value Example                   |
| :----------- | :------------------------------ |
| `sv-api-key` | `SV.pk_live_xxxx.operator-slug` |

<CodeGroup>
  ```json headers.json theme={null}
  {
    "header": {
      "sv-api-key": "YOUR_CONCATENATED_KEY"
    }
  }
  ```
</CodeGroup>

## Base URLs

Access our API via the following environments:

| Environment | Base URL                                                                                     |
| :---------- | :------------------------------------------------------------------------------------------- |
| Staging     | [https://api-staging.smatvirtual.com/api/v1.1](https://api-staging.smatvirtual.com/api/v1.1) |
| Production  | [https://api-prod.smatvirtual.com/api/v1.1](https://api-prod.smatvirtual.com/api/v1.1)       |

## Swagger Documentation URLs

Access our API swagger documentation via the following environments:

| Environment            | Base URL                                                                                                           |
| :--------------------- | :----------------------------------------------------------------------------------------------------------------- |
| Operator \[Staging]    | [https://api-staging.smatvirtual.com/v1/merchant/swagger](https://api-staging.smatvirtual.com/v1/merchant/swagger) |
| Operator \[Production] | [https://api-prod.smatvirtual.com/v1/merchant/swagger](https://api-prod.smatvirtual.com/v1/merchant/swagger)       |
| Provider \[Staging]    | [https://api-staging.smatvirtual.com/v1/provider/swagger](https://api-staging.smatvirtual.com/v1/provider/swagger) |
| Provider \[Production] | [https://api-prod.smatvirtual.com/v1/provider/swagger](https://api-prod.smatvirtual.com/v1/provider/swagger)       |

<Note>
  Pro-Tip: Use the "Try It" console on the following pages to test your
  sv-api-key against our staging environment in real-time.
</Note>