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

# Make your first API call

This tutorial guides you step by step through authenticating with the Quivo API and making your first API call to verify your setup.

## Prerequisites

Before you start, make sure you have:

* **Static API Key:** Your static API key provided by Quivo. You can retrieve it from the Quivo Dashboard.
* **Username:** Your Quivo account username.
* **Password:** Your Quivo account password.

<Note>
  All API examples in this guide use `${BASE_URL}` as a placeholder. Replace it with the correct base URL configured for the correct environment. For more information see [Environments page](/api-reference/environments).
</Note>

## Step 1: Obtain a session token

Exchange your credentials for a session token via the `POST /login` endpoint.

<Tabs>
  <Tab title="Request">
    Use this request to exchange your credentials for a session token:

    ```bash theme={null}
    curl -X POST "${BASE_URL}/login" \
      -H "Content-Type: application/json" \
      -H "X-Api-Key: <YOUR_STATIC_API_KEY>" \
      -d '{
        "username": "<YOUR_USERNAME>",
        "password": "<YOUR_PASSWORD>"
      }'
    ```
  </Tab>

  <Tab title="Response">
    A successful request returns a `200 OK` status code. The API returns a token string in the response:

    ```json theme={null}
    {
      "Token": "<YOUR_SESSION_TOKEN>"
    }
    ```

    Save the `Token` value from the response. You'll use it in the next step.
  </Tab>
</Tabs>

## Step 2: Make your first authenticated API call

Include the session token in the `Authorization` header of your API request. The following example shows how to make an authenticated request using the [`GET /sellers endpoint`](/api-reference/#tag/sellers) to retrieve your seller information.

<Tabs>
  <Tab title="Request">
    Use this request to retrieve your seller information:

    ```bash theme={null}
    curl -X GET "${BASE_URL}/sellers" \
      -H "X-Api-Key: <YOUR_STATIC_API_KEY>" \
      -H "Authorization: <YOUR_SESSION_TOKEN>"
    ```
  </Tab>

  <Tab title="Response">
    A successful authenticated request returns a `200 OK` status code with your seller information:

    ```json theme={null}
    {
      "sellerId": <YOUR_SELLER_ID>,
      "name": "<SELLER_NAME>",
      "status": "<STATUS>"
    }
    ```

    If authentication fails, you will receive a `401 Unauthorized` error. In that case, check that:

    * Your API key is correct
    * Your username and password are correct
    * Your session token has not expired (tokens expire after 1 hour)
  </Tab>
</Tabs>

## Verify your setup

If you received a successful response with your seller information, congratulations! Your API setup is working correctly. You can now proceed with other API operations.

## Where to go next

Now that you have made your first API call, continue with these guides:

<CardGroup cols={2}>
  <Card title="Send Inventory" icon="warehouse" href="/docs/quickstart/send-inventory">
    Send your products to Quivo warehouses to make them available for fulfillment.
  </Card>

  <Card title="Create a Fulfillment Order" icon="shopping-cart" href="/docs/quickstart/create-order">
    Programmatically submit fulfillment orders to trigger the pick and pack process.
  </Card>
</CardGroup>