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

# Quickstart

> Make your first API call in minutes

Get up and running with the Fourthwall API in three steps.

## 1. Get your API credentials

> [!NOTE]
>
> Creating API credentials requires the **SUPER ADMIN** role.

1. Go to [Settings > For Developers](https://my-shop.fourthwall.com/admin/dashboard/settings/for-developers?redirect)
2. Under "Open API", click **Create API User**
3. Save the username and password that are generated

## 2. Make your first API call

Test your credentials by fetching your shop details. The Fourthwall API uses **Basic Authentication** - simply pass your username and password with each request.

```bash cURL theme={null}
# Basic Auth - the simplest way to authenticate
curl -u "your_username:your_password" \
  https://api.fourthwall.com/open-api/v1.0/shops/current
```

```javascript JavaScript theme={null}
const username = "your_username";
const password = "your_password";

// Basic Auth: base64 encode "username:password"
const credentials = btoa(`${username}:${password}`);

fetch("https://api.fourthwall.com/open-api/v1.0/shops/current", {
  headers: {
    "Authorization": `Basic ${credentials}`
  }
})
  .then(res => res.json())
  .then(data => console.log(data));
```

```python Python theme={null}
import requests
from requests.auth import HTTPBasicAuth

# Basic Auth is built into the requests library
response = requests.get(
    "https://api.fourthwall.com/open-api/v1.0/shops/current",
    auth=HTTPBasicAuth("your_username", "your_password")
)
print(response.json())
```

> [!TIP]
>
> The `-u` flag in cURL automatically handles Basic Auth encoding for you. Under the hood, it creates an `Authorization: Basic <base64-encoded-credentials>` header.

You should receive a response with your shop details:

```json theme={null}
{
  "id": "sh_abc123",
  "name": "My Shop",
  "currency": "USD",
  ...
}
```

## 3. Explore the API

Now that you're authenticated, explore what you can build:

> [card] [List Orders](https://docs.fourthwall.com/api-reference/platform/orders/list-orders.md)
>
> Fetch orders from your shop

> [card] [List Products](https://docs.fourthwall.com/api-reference/platform/products/list-products.md)
>
> Get your product catalog

> [card] [Set up Webhooks](https://docs.fourthwall.com/webhooks/getting-started.md)
>
> Get real-time event notifications

> [card] [Full API Reference](https://docs.fourthwall.com/api-reference/platform/shop/get-current-shop.md)
>
> Browse all available endpoints


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.