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

# Introduction

> Get started with the bitbybit Open API

## Overview

The bitbybit Open API provides programmatic access to your bitbybit data. You can manage customers, orders, and products through a RESTful API secured with API key authentication.

### Base URLs

| Service                     | Base URL                                       |
| --------------------------- | ---------------------------------------------- |
| Customers, Orders, Products | `https://api.bitbybit.studio/customer/open/v1` |
| Messaging                   | `https://api.bitbybit.studio/whatsapp/open/v1` |

### Quick Start

1. Go to **Settings > Developer** in your bitbybit dashboard
2. Click **Create API Key** and select the scopes you need
3. Copy the API key (it's only shown once)
4. Include it in every request via the `x-api-key` header

```bash theme={null}
curl -X GET "https://api.bitbybit.studio/customer/open/v1/customers" \
  -H "x-api-key: bbb_live_your_api_key_here"
```

### Response Format

**Success (single resource):**

```json theme={null}
{
  "data": { ... }
}
```

**Success (collection):**

```json theme={null}
{
  "data": [ ... ],
  "meta": {
    "page": 1,
    "limit": 20,
    "total": 100,
    "hasNextPage": true
  }
}
```

**Error:**

```json theme={null}
{
  "error": {
    "code": "NOT_FOUND",
    "message": "Customer not found"
  }
}
```

### Available Resources

<CardGroup cols={2}>
  <Card title="Customers" icon="users" href="/api-reference/endpoint/customers/list">
    Create, read, update, and delete customers
  </Card>

  <Card title="Orders" icon="shopping-cart" href="/api-reference/endpoint/orders/list">
    Manage orders and fulfillment
  </Card>

  <Card title="Products" icon="box" href="/api-reference/endpoint/products/list">
    Manage your product catalog
  </Card>

  <Card title="Messaging" icon="message" href="/api-reference/endpoint/messages/send">
    Send and track WhatsApp messages
  </Card>

  <Card title="Loyalty" icon="gift" href="/api-reference/endpoint/loyalty-customers/overview">
    Manage loyalty settings, points, rewards, and redemptions
  </Card>

  <Card title="Webhooks" icon="bell" href="/api-reference/webhooks/overview">
    Receive real-time event notifications
  </Card>
</CardGroup>