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

# Quickstart

Make your first API call and start building a custom storefront with Leyyow.

## Prerequisites

Before making your first request, you'll need the following:

* [A Leyyow account.](https://suite.leyyow.com)
* [A Leyyow API Key](https://suite.leyow.com/settings)

## Make your first API call

Follow these steps to authenticate your request and retrieve data from your Leyyow store.

<Steps>
  <Step title="Get your API key">
    Your API key is created and managed in the Leyyow Suite.

    <Card>
      1. Log into your Leyyow account
      2. Go to **settings**
      3. Select **API Key**  from the side navigation
      4. Click on **Generate API Key**  to generate a new API
    </Card>

    ```bash theme={null}
    npm install your-package
    ```
  </Step>

  <Step title="Authenticate your request">
    Include your API key in the Authorization header of every request.

    ```curl theme={null}
    Authorization: Bearer <merchant-api-key>
    ```

    <Warning>
      Keep your API key private and never expose it in client-side code.
    </Warning>
  </Step>

  <Step title="Run it">
    Let's make a request to fetch your store details.

    <CodeGroup>
      ```bash cURL theme={null}
      curl -X GET https://api.leyyow.com/api/public/v1/store \
        -H "Authorization: Bearer LEYYOW_API_KEY" \
        -H "Content-Type: application/json"
      ```

      ```javascript JavaScript theme={null}
      const response = await fetch("https://api.leyyow.com/api/public/v1/store", {
        headers: {
          "Authorization": "Bearer LEYYOW_API_KEY",
          "Content-Type": "application/json"
        }
      });

      const data = await response.json();
      console.log(data);
      ```

      ```php PHP theme={null}
      $ch = curl_init("https://api.leyyow.com/api/public/v1/store");
      curl_setopt($ch, CURLOPT_HTTPHEADER, [
          "Authorization: Bearer LEYYOW_API_KEY",
          "Content-Type: application/json"
      ]);
      curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);

      $response = curl_exec($ch);
      curl_close($ch);

      $data = json_decode($response, true);
      ```
    </CodeGroup>

    A successful response returns your store information.

    ```json JSON theme={null}
    {
      "error": null,
      "message": "Store retrieved.",
      "data": {
        "uid": "a1b2c3d4-5678-90ab-cdef-1234567890ab",
        "store_name": "Leyyow Demo Store",
        "slug": "leyyow-demo",
        "delivery_enabled": true,
        "manual_delivery_enabled": true,
        "express_delivery_enabled": false,
        "tax_collection_enabled": true,
        "tax_rate": "7.50",
        "is_live": true
      }
    }
    ```
  </Step>
</Steps>

<Tip>
  Need help? Reach out to us at [support@leyyow.com](mailto:support@leyyow.com).
</Tip>