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=balanceExample 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=balanceIntroduction
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
Request
curl -X POST https://gunsview.com/api/v2 \
-d key=gv_live_xxxxxxxxxxxxxxxx \
-d action=servicesResponse
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
servicesResponse fields
service in the add action.guns.lol.curl -X POST https://gunsview.com/api/v2 \
-d key=gv_live_xxxxxxxxxxxxxxxx \
-d action=servicesExample 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
addservice field from the services response.username.Response fields
status action.curl -X POST https://gunsview.com/api/v2 \
-d key=gv_live_xxxxxxxxxxxxxxxx \
-d action=add \
-d service=1 \
-d link=usernameExample 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
status12345,12346.Response fields
Status values
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=12345Example 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
balanceResponse fields
TRY.curl -X POST https://gunsview.com/api/v2 \
-d key=gv_live_xxxxxxxxxxxxxxxx \
-d action=balanceExample 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
Bearer <key>.application/json for requests with a body.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
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
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
Bearer <key>application/jsonBody · JSON
id from the GET /packages response.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
id from the POST /orders response.Response fields
null if it hasn't started.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
{
"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.
curl -o openapi.json https://gunsview.com/api/openapi.jsonStuck 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.