> ## 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.
</Note>

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.

<CodeGroup>
  ```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())
  ```
</CodeGroup>

<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.
</Tip>

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:

<CardGroup cols={2}>
  <Card title="List Orders" icon="box" href="/api-reference/platform/orders/list-orders">
    Fetch orders from your shop
  </Card>

  <Card title="List Products" icon="tag" href="/api-reference/platform/products/list-products">
    Get your product catalog
  </Card>

  <Card title="Set up Webhooks" icon="webhook" href="/webhooks/getting-started">
    Get real-time event notifications
  </Card>

  <Card title="Full API Reference" icon="book" href="/api-reference/platform/shop/get-current-shop">
    Browse all available endpoints
  </Card>
</CardGroup>