API documentation

Quick start

Works with any SMM panel that supports the standard API v2: add Klvn Store as a provider with the URL and key below. Or call it yourself, as in the examples.

Place an order

Creates an order and takes the price from your balance straight away.

curl -X POST https://kalvn.store/api/v2 \
  -d key=YOUR_API_KEY \
  -d action=add \
  -d service=1 \
  -d link=https://www.snapchat.com/add/username \
  -d quantity=750

{"order":1024,"charge":"4.5000","balance":"95.5000","currency":"USD"}

Order status

Check where an order is. Poll this, for example every few minutes.

curl -X POST https://kalvn.store/api/v2 \
  -d key=YOUR_API_KEY \
  -d action=status \
  -d order=1024

{"charge":"4.5000","start_count":"0","status":"In progress","remains":"750","currency":"USD"}

Status of many orders

Up to 100 order IDs, comma separated.

curl -X POST https://kalvn.store/api/v2 \
  -d key=YOUR_API_KEY \
  -d action=status \
  -d orders=1024,1025

{"1024":{"charge":"4.5000","start_count":"0","status":"Completed","remains":"0","currency":"USD"},"1025":{"error":"Incorrect order ID"}}

Balance

Your current balance.

curl -X POST https://kalvn.store/api/v2 \
  -d key=YOUR_API_KEY \
  -d action=balance

{"balance":"100.0000","currency":"USD"}

Services

Service IDs, your rate per 1000 and the quantity limits.

curl -X POST https://kalvn.store/api/v2 \
  -d key=YOUR_API_KEY \
  -d action=services

[{"service":1,"name":"Arab Snapchat Followers","type":"Default","category":"Snapchat","rate":"6.0000","min":"100","max":"10000","refill":false,"cancel":true}]

Cancel orders

Only orders that have not started can be canceled. The charge goes back to your balance.

curl -X POST https://kalvn.store/api/v2 \
  -d key=YOUR_API_KEY \
  -d action=cancel \
  -d orders=1024

[{"order":1024,"cancel":"1"}]

Sending JSON instead

curl -X POST https://kalvn.store/api/v2 \
  -H "Content-Type: application/json" \
  -d '{"key":"YOUR_API_KEY","action":"add","link":"https://www.snapchat.com/add/username","quantity":750}'

PHP example

<?php
$response = file_get_contents('https://kalvn.store/api/v2', false, stream_context_create([
    'http' => [
        'method'  => 'POST',
        'header'  => 'Content-Type: application/x-www-form-urlencoded',
        'content' => http_build_query([
            'key'      => 'YOUR_API_KEY',
            'action'   => 'add',
            'service'  => 1,
            'link'     => 'https://www.snapchat.com/add/username',
            'quantity' => 750,
        ]),
    ],
]));

$order = json_decode($response, true);
echo $order['order'] ?? $order['error'];

Order statuses

Errors

Every error comes back as {"error":"message"}.