gunsview.com

API docs

gunsview API reference

SMM Panel v2 compatible actions plus a REST API v1 for your own software. Connect your panel or build your client.

Introduction

Getting started

Every request goes over HTTPS. SMM Panel v2 has a single endpoint: https://gunsview.com/api/v2. Send requests with POST; the body can be form-encoded (application/x-www-form-urlencoded) or JSON.

Every request carries your API key in the key parameter and the action in the action parameter. Keys start with gv_live_ and live in your reseller panel.

Writing your own software? Use the REST API v1: JSON endpoints under https://gunsview.com/api/v1 with a Bearer key.

SMM Panel v2 URL
https://gunsview.com/api/v2
REST API v1 URL
https://gunsview.com/api/v1
Method
v2: POST · v1: GET / POST
Body
form-encoded or JSON
Response
JSON
Key format
gv_live_…

Your first request: check your balance

curl -X POST https://gunsview.com/api/v2 \
  -d key=gv_live_xxxxxxxxxxxxxxxx \
  -d action=balance

Example response · 200

{
  "balance": "500.00",
  "currency": "TRY"
}

Introduction

Authentication

Your API key is in your reseller panel. On SMM Panel v2, send it in the key parameter; on the REST API, send it in the Authorization: Bearer <key> header.

Your key can spend your balance. Keep it on the server only; never put it in browser code, a mobile app or a public repository.

If you think your key has leaked, message us on the reseller line in our Discord right away.

curl -X POST https://gunsview.com/api/v2 \
  -d key=gv_live_xxxxxxxxxxxxxxxx \
  -d action=balance

Introduction

Try it in the console

Paste your key, pick the services or balance action and send. You'll see the request and the response side by side.

The console only runs read actions: it never places an order or touches your balance.

API console

Action

Request

curl -X POST https://gunsview.com/api/v2 \
  -d key=gv_live_xxxxxxxxxxxxxxxx \
  -d action=services

Response

The response will show up here.

SMM Panel v2

POST/api/v2action=services

List services

Returns every service available to your account with its price per 1,000 views. Prices come with your reseller tier applied.

Parameters

NameTypeRequiredDescription
keystringRequiredYour API key.
actionstringRequiredValue: services

Response fields

NameTypeDescription
serviceintegerService ID. Send it as service in the add action.
namestringService name.
categorystringThe service's platform, e.g. guns.lol.
ratestringPrice per 1,000 views.
minstringMinimum order quantity.
maxstringMaximum order quantity.
curl -X POST https://gunsview.com/api/v2 \
  -d key=gv_live_xxxxxxxxxxxxxxxx \
  -d action=services

Example response · 200

[
  {
    "service": 1,
    "name": "guns.lol View",
    "category": "guns.lol",
    "rate": "5.20",
    "min": "100",
    "max": "10000"
  },
  {
    "service": 2,
    "name": "feds.lol View",
    "category": "feds.lol",
    "rate": "5.20",
    "min": "100",
    "max": "10000"
  }
]

SMM Panel v2

POST/api/v2action=add

Create an order

Places a new order for the given profile and returns the order number. The amount is deducted from your balance.

Delivery only needs the public username. Never ask your customers for a password.

Parameters

NameTypeRequiredDescription
keystringRequiredYour API key.
actionstringRequiredValue: add
serviceintegerRequiredService ID; the service field from the services response.
linkstringRequiredUsername of the profile to deliver to, e.g. username.

Response fields

NameTypeDescription
orderintegerOrder number. Check its progress with the status action.
curl -X POST https://gunsview.com/api/v2 \
  -d key=gv_live_xxxxxxxxxxxxxxxx \
  -d action=add \
  -d service=1 \
  -d link=username

Example response · 200

{
  "order": 12345
}

SMM Panel v2

POST/api/v2action=status

Order status

Returns an order's status and delivery counts. For several orders, send their numbers separated by commas in the orders parameter.

Either order or orders is required.

Parameters

NameTypeRequiredDescription
keystringRequiredYour API key.
actionstringRequiredValue: status
orderintegerOptionalA single order number.
ordersstringOptionalComma-separated order numbers, e.g. 12345,12346.

Response fields

NameTypeDescription
statusstringThe order's status; values are listed below.
start_countstringThe profile's counter when the order started.
remainsstringAmount still waiting to be delivered.

Status values

ValueTypeDescription
PendingstringOrder received and waiting in the queue.
In progressstringDelivery is underway.
CompletedstringThe full amount was delivered.
PartialstringPart of it was delivered; the rest was refunded to your balance.
CanceledstringThe order couldn't be delivered; the full amount was refunded to your balance.

Several orders

When you query with orders, the response is an object keyed by order number.

{
  "12345": {
    "status": "Completed",
    "start_count": "1204",
    "remains": "0"
  },
  "12346": {
    "status": "Partial",
    "start_count": "860",
    "remains": "120"
  }
}
curl -X POST https://gunsview.com/api/v2 \
  -d key=gv_live_xxxxxxxxxxxxxxxx \
  -d action=status \
  -d order=12345

Example response · 200

{
  "status": "In progress",
  "start_count": "1204",
  "remains": "380"
}

SMM Panel v2

POST/api/v2action=balance

Balance

Returns the available balance on your account and its currency.

Parameters

NameTypeRequiredDescription
keystringRequiredYour API key.
actionstringRequiredValue: balance

Response fields

NameTypeDescription
balancestringAvailable balance as a string with two decimals.
currencystringCurrency of the balance, e.g. TRY.
curl -X POST https://gunsview.com/api/v2 \
  -d key=gv_live_xxxxxxxxxxxxxxxx \
  -d action=balance

Example response · 200

{
  "balance": "500.00",
  "currency": "TRY"
}

REST API v1

GET · POST/api/v1

REST API v1

A JSON API for your own software. The base URL is https://gunsview.com/api/v1. Send your key in the Authorization header on every request, and use Content-Type: application/json for requests with a body.

When a request fails, the HTTP status code reflects the error and the body contains an error object.

Headers

NameTypeRequiredDescription
AuthorizationstringRequiredYour API key as Bearer <key>.
Content-TypestringOptionalapplication/json for requests with a body.
Idempotency-KeystringOptionalOnly for POST /orders. A unique value for every new order.
curl https://gunsview.com/api/v1/balance \
  -H "Authorization: Bearer gv_live_xxxxxxxxxxxxxxxx"

Example response · 200

{
  "balance": "500.00",
  "currency": "TRY"
}

REST API v1

GET/api/v1/packages

List packages

Returns the packages you can buy and their prices. When ordering, send the package's id as packageId.

Response fields

NameTypeDescription
idintegerPackage ID.
platformstringThe package's platform.
namestringPackage name.
quantityintegerNumber of views in the package.
pricestringPrice with your reseller tier applied.
currencystringCurrency of the price.
curl https://gunsview.com/api/v1/packages \
  -H "Authorization: Bearer gv_live_xxxxxxxxxxxxxxxx"

Example response · 200

[
  {
    "id": 1,
    "platform": "guns.lol",
    "name": "guns.lol View 1000",
    "quantity": 1000,
    "price": "260.00",
    "currency": "TRY"
  },
  {
    "id": 2,
    "platform": "guns.lol",
    "name": "guns.lol View 2500",
    "quantity": 2500,
    "price": "587.50",
    "currency": "TRY"
  }
]

REST API v1

GET/api/v1/balance

Balance

Returns your available balance and its currency.

Response fields

NameTypeDescription
balancestringAvailable balance as a string with two decimals.
currencystringCurrency of the balance.
curl https://gunsview.com/api/v1/balance \
  -H "Authorization: Bearer gv_live_xxxxxxxxxxxxxxxx"

Example response · 200

{
  "balance": "500.00",
  "currency": "TRY"
}

REST API v1

POST/api/v1/orders

Create an order

Places a new order with the package you choose. The amount is deducted from your balance and the order object is returned.

Headers

NameTypeRequiredDescription
AuthorizationstringRequiredBearer <key>
Content-TypestringRequiredapplication/json
Idempotency-KeystringOptionalA unique value for every new order, e.g. a UUID.

Body · JSON

NameTypeRequiredDescription
packageIdintegerRequiredPackage ID; the id from the GET /packages response.
targetstringRequiredUsername of the profile to deliver to.
curl -X POST https://gunsview.com/api/v1/orders \
  -H "Authorization: Bearer gv_live_xxxxxxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: 3f9c2a7e-5b1d-4e8a-9c6f-0d2b7a1e4c55" \
  -d '{"packageId":1,"target":"username"}'

Example response · 201

{
  "id": 12345,
  "status": "pending",
  "packageId": 1,
  "target": "username",
  "quantity": 1000,
  "delivered": 0,
  "startCount": null,
  "createdAt": "2026-10-29T18:42:00Z"
}

REST API v1

GET/api/v1/orders/:id

Retrieve an order

Returns the current status and delivery counts of a single order.

Statuses match v2, written in lowercase with underscores: pending, in_progress, completed, partial, canceled.

Path parameter

NameTypeRequiredDescription
idintegerRequiredOrder ID; the id from the POST /orders response.

Response fields

NameTypeDescription
idintegerOrder ID.
statusstringThe order's status.
targetstringThe profile being delivered to.
quantityintegerOrdered amount.
deliveredintegerAmount delivered so far.
startCountinteger | nullThe profile's counter when the order started; null if it hasn't started.
createdAtstringWhen the order was created (ISO 8601, UTC).
curl https://gunsview.com/api/v1/orders/12345 \
  -H "Authorization: Bearer gv_live_xxxxxxxxxxxxxxxx"

Example response · 200

{
  "id": 12345,
  "status": "in_progress",
  "packageId": 1,
  "target": "username",
  "quantity": 1000,
  "delivered": 620,
  "startCount": 1204,
  "createdAt": "2026-10-29T18:42:00Z"
}

Reference

Error format

When something goes wrong, the response contains an error field. On SMM Panel v2 it's a string; on the REST API it's an object with code and message, and the HTTP status code reflects the error.

v2 error messages may change. In your code, check whether the response has an error field rather than matching the text.

Error codes

NameHTTPDescription
invalid_request400A parameter is missing or invalid.
invalid_key401The key is missing, wrong or disabled.
insufficient_balance402Your balance doesn't cover this order.
not_found404Order or package not found.
idempotency_conflict409The same Idempotency-Key was used with a different body.
server_error500Something went wrong on our side. Try again shortly and check the status page.
{
  "error": "Invalid API key"
}

Reference

OpenAPI spec

The REST API v1 is published as an OpenAPI spec. Import it into tools like Postman or Insomnia, or generate your own client automatically.

OpenAPI spec (openapi.json)
curl -o openapi.json https://gunsview.com/api/openapi.json

Stuck on something?

Message the reseller line in our Discord with your order number or request. The live state of delivery and the API is on the status page.