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

# Lojou Developer

> Official reference for the Lojou v1 API.

The Lojou API lets you create products, process orders, manage subscription plans, and receive webhooks for store events — everything you need to integrate an external app with a Lojou store.

<CardGroup cols={2}>
  <Card title="Get started in 5 minutes" icon="rocket" href="/en/quickstart">
    Generate an API key and make your first call.
  </Card>

  <Card title="Authentication" icon="key" href="/en/authentication">
    API key or OAuth — how each one works.
  </Card>

  <Card title="Connect via OAuth" icon="plug" href="/en/oauth">
    For apps that other sellers will install on their own store.
  </Card>

  <Card title="Webhooks" icon="webhook" href="/en/webhooks">
    The exact payload Lojou sends, and when.
  </Card>

  <Card title="API Reference" icon="code" href="/api-reference">
    Every endpoint, parameter, and response.
  </Card>
</CardGroup>

## Base URL

```
https://api.lojou.app
```

## Version

Every endpoint documented here uses the `/v1` prefix.

## Two ways to authenticate

* **API key** — to integrate your own store. Generate one under `Settings → API` in the Lojou dashboard.
* **OAuth** — to build an app that other sellers will install and authorize on their own store. See the [OAuth guide](/en/oauth).

Both use the same header:

```http theme={null}
Authorization: Bearer <token>
```

## Response format

Every API response follows the same shape:

```json theme={null}
{
  "status": "success",
  "message": "...",
  "data": { }
}
```

Errors follow the same pattern, with `status: "error"`:

```json theme={null}
{
  "status": "error",
  "message": "Permission denied for this endpoint.",
  "error_code": "insufficient_scope"
}
```

## Need help?

Reach out to Lojou support from the dashboard, or call `GET /v1/scopes` (documented in the [API reference](/api-reference)) to see exactly what your token can do.