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

# Introduction

# Skycoach Marketplace API

> **REST API for automating marketplace workflows on Skycoach**

Welcome to Skycoach Marketplace API — your gateway to programmatically manage products, offers, credentials, and marketplace operations. Our API enables seamless integration of Skycoach's marketplace functionality into your business tools and automated workflows.

## Base URL

All API requests should be made to:

```
https://skycoach.gg/api/shop/marketplace
```

Make sure to include the full path `/api/shop/marketplace` in your API calls.

**Examples:**

```
https://skycoach.gg/api/shop/marketplace/products/list
https://skycoach.gg/api/shop/marketplace/offers/my
```

## Quick Start

Follow these steps to get started with the Skycoach Marketplace API:

1. **[Get your API token](./get-api-token)** — Generate and securely store your Bearer token
2. **[Authenticate your requests](#authentication)** — Set up Bearer token authentication
3. **[Create your first offer](./creating-offers)** — Learn how to create and publish offers
4. **[Rate limit information](#rate-limiting)** — Review the request rate limits.

## Core Endpoints

The Skycoach Marketplace API provides comprehensive endpoints for managing your marketplace operations:

* **Products**: Retrieve available products for creating offers
* **Offers**: Create, update, and manage your marketplace offers
* **Credentials**: Handle login credentials for your offers
* **Status Management**: Monitor and control offer statuses

For detailed endpoint documentation, see the [API Reference](./api-reference).

## Authentication

All API requests require authentication using Bearer tokens. Learn how to generate and manage your API tokens in our [authentication guide](./get-api-token).

**Example:**

```bash theme={null}
curl -H "Authorization: Bearer YOUR_API_TOKEN" \
     https://skycoach.gg/api/shop/marketplace/products/list
```

## API Responses

The Skycoach Marketplace API uses consistent JSON response formats across all endpoints. Responses include:

* **Success indicators**: Clear success/failure status
* **Structured data**: Consistent data format for easy parsing
* **Error details**: Comprehensive error messages with context
* **Timestamps**: ISO 8601 formatted timestamps

## Rate Limiting

All API requests are subject to rate limiting to ensure service stability and fair usage:

* **Global Limit**: 120 requests per minute
* **Shared Across Endpoints**: All marketplace endpoints share the same rate limit pool
* **Reset Window**: Rolling 60-second window

### Documentation and Resources

* **API Reference**: Complete endpoint documentation with examples at [API Reference](./api-reference)
* **Token Guide**: Step-by-step instructions for [getting your API token](./get-api-token)
* **Creating Offers**: Learn how to [create and publish offers](./creating-offers)

## Next Steps

Ready to start building? Follow these steps:

1. **Get your API key**\
   Visit your dashboard to generate your API token. See the [token guide](./get-api-token) for detailed instructions.

2. **Authenticate your requests**\
   Follow our [Authentication Guide](./get-api-token) to set up Bearer token authentication in your application.

3. **Create your first offer**\
   Learn the complete workflow for [creating and publishing offers](./creating-offers), including draft management and review process.

4. **Implement best practices**\
   Review our [API Overview](./api-reference) for rate limiting strategies, error handling, and security guidelines.

***