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

# Introduction

> Manastore API Documentation

## Welcome to Manastore API

The Manastore API provides endpoints for managing orders, products, and wallets. Build powerful applications with our comprehensive REST API.

<Card title="OpenAPI Specification" icon="code" href="https://github.com/git-wahab/docs/blob/manastore-open-api/api-reference/openapi.json">
  View the complete OpenAPI specification
</Card>

## Authentication

All API endpoints require a **Bearer token**, which must be included in the `Authorization` header of every request:

```
Authorization: Bearer your-token-here
```

### How to Generate Your API Key

<Steps>
  <Step title="Login to Manastore">
    Login to your [Manastore account](https://manastore.com/).
  </Step>

  <Step title="Navigate to API Key Settings">
    Go to **Account Settings** → **API Key**.
  </Step>

  <Step title="Generate API Key">
    Click on **Generate API Key** to create your Bearer token.
  </Step>
</Steps>

## Request Headers

All requests must include the following header:

```
Accept: application/json
```

## API Base URL

<Tabs>
  <Tab title="Staging">
    ```
    https://api-staging.manastore.com/api/v1
    ```
  </Tab>

  <Tab title="Live">
    ```
    https://api.manastore.com/api/v1
    ```
  </Tab>
</Tabs>

## Response Format

All successful responses return JSON data with the following structure:

* **Paginated Responses**: Include `data`, `links`, and `meta` objects
* **Error Responses**: Include `message` and optional `errors` object for validation errors
* **Single Resources**: Return the resource object directly

## Currency Conversion

Conversion fees applied to orders in a currency different from the base currency are calculated using live exchange rates from [ExchangeRate-API](https://www.exchangerate-api.com).

## Endpoints Overview

The API is organized into three main categories:

* **Orders**: Manage customer orders, download invoices and digital codes
* **Products**: Browse products, search, and retrieve product details
* **Wallets**: Manage user wallets and check balances