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 action=add

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 action=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 action=status

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 action=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 action=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":false}]

Cancel orders action=cancel

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"}.