Skip to main content
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.
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.

​
Step 1: Obtain a session token

Exchange your credentials for a session token via the POST /login endpoint.
Use this request to exchange your credentials for a session token:
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>"
  }'

​
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 to retrieve your seller information.
Use this request to retrieve your seller information:
curl -X GET "${BASE_URL}/sellers" \
  -H "X-Api-Key: <YOUR_STATIC_API_KEY>" \
  -H "Authorization: <YOUR_SESSION_TOKEN>"

​
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:

Send Inventory

Send your products to Quivo warehouses to make them available for fulfillment.

Create a Fulfillment Order

Programmatically submit fulfillment orders to trigger the pick and pack process.