API Reference/Authentication

Authentication

The Sellvy API uses API keys to authenticate requests. You can manage your API keys from your dashboard under Settings → API Keys.

Base URL

https://api.sellvy.io/v1

All API endpoints are relative to this base URL. All requests must be made over HTTPS.

API key types

Sellvy provides two types of API keys for different environments:

Key Prefix	Environment	Description
`sk_live_`	Production	Use for live transactions. Creates real orders and charges real money.
`sk_test_`	Sandbox	Use for development and testing. No real charges are made.

Warning: Keep your API keys secret. Never expose them in client-side code, public repositories, or frontend bundles. Use environment variables on your server.

Header format

Include your API key in the Authorization header as a Bearer token:

const response = await fetch("https://api.sellvy.io/v1/products", {
  method: "GET",
  headers: {
    "Authorization": "Bearer sk_live_your_api_key",
    "Content-Type": "application/json"
  }
});

const data = await response.json();

Error responses

If authentication fails, the API returns one of the following:

Status	Error	Meaning
`401`	unauthorized	No API key provided or the key is invalid.
`403`	forbidden	The API key does not have permission for this resource.

Rate limits

API rate limits vary by plan. Exceeding the limit returns a 429 Too Many Requests response with a Retry-After header.

Plan	Requests / minute	Requests / day
Free	60	5,000
Pro	300	50,000
Business	1,000	Unlimited

Quickstart Products

Was this page helpful?