KVKamiVerify

Virtual number API and SMM panel API for resellers

Sell our numbers and boosting from your own platform.

Two APIs, one balance. Numbers speak the SMS-Activate protocol and boosting speaks the standard SMM panel protocol, so most of the time you point code you already have at us and it works. Add funds once, resell at your own prices.

v1 SMS numbers v2 SMM services 200+ countries SMS-Activate compatible 0 integration fee

Getting started

Three steps, and none of them needs us to approve you.

  1. Get your keys. Create an account and open API keys. Both keys are already there: one for numbers, one for boosting.
  2. Add funds. Pay by Mobile Money, card or crypto. API orders spend the same balance as the website.
  3. Call it. One HTTPS request. No SDK to install, no OAuth, no sandbox key to swap out later.
Your first call: what is my balance?
curl "https://kamiverify.com/api/v2" \
  -d "key=YOUR_SMM_KEY" \
  -d "action=balance"

# {"balance":"12.4400","currency":"USD"}

Authentication

You have two keys, not one. Each key opens one API:

api_keyv1, SMS numbers. Your numbers key. Works on /api/v1 and /stubs/handler_api.php.
keyv2, SMM services. Your boosting key. Works on /api/v2.

They are separate on purpose. You can give a developer or a child panel your boosting catalogue without letting them spend your balance on numbers, and you can replace one key after a leak without breaking the other integration.

A key only opens its own API. The boosting key sent to /api/v1 fails exactly like an unknown key, and the other way round too.

Both keys are on your API keys page, with a button to replace either one. There is no signature and no token to refresh.

v2 expects a POST form field. v1 accepts GET or POST: the SMS-Activate habit is GET, and most client libraries use it. A key in a URL ends up in server logs, browser history and referrer headers, so use POST wherever your library allows it.

Your key is your balance. Anyone holding it can spend everything on your account. Keep it on your server: never in a mobile app, never in browser JavaScript, never in a public repository. If it leaks, press Replace this key on the API keys page. The old key stops working at once.

Balance and pricing

API orders and website orders spend the same balance. There is no separate developer wallet and no minimum monthly spend.

Balances are kept in US dollars, and both APIs quote and charge in USD. The price the API gives you is the price you are charged.

You set your own prices for your own customers. We bill you the API price and nothing else: no revenue share, no fee per call.

No balance means no order, not a queued order. An add or getNumber call on an empty balance fails at once. Check balance on a schedule and add funds before you run out: an order that fails at 2am is a customer you lose.

v1 SMS numbers

Get a real number in one of 200+ countries, read the code it receives, and release it. The whole thing usually takes less than two minutes.

v1 speaks the SMS-Activate protocol, not JSON. If you have used a number provider before, it will look familiar: the credential is api_key, replies are plain strings like ACCESS_NUMBER:880412:237650112233, and setStatus takes numbers, not words. Three actions reply in JSON: that is how the protocol works, and we copy it so existing client libraries keep working.
Base URLhttps://kamiverify.com/api/v1

The usual path https://kamiverify.com/stubs/handler_api.php reaches the same handler. Most SMS-Activate libraries hard-code that path, so switching one to KamiVerify is usually a one-line change of host name.

Country ids follow the SMS-Activate list: 41 Cameroon, 19 Nigeria, 187 United States, 12 United States (virtual). getCountries returns all of them.

GET or POSTaction=getBalanceWhat is on the account
ParameterTypeWhat it is
api_key requiredstringYour numbers key.
action requiredstringThe word getBalance.

Replies ACCESS_BALANCE:12.44.

GET or POSTaction=getCountriesCountries with numbers in stock
ParameterTypeWhat it is
api_key requiredstringYour numbers key.
action requiredstringThe word getCountries.

Replies in JSON: {"41":{"id":41,"eng":"Cameroon"}}.

GET or POSTaction=getNumbersStatusHow many numbers are free
ParameterTypeWhat it is
api_key requiredstringYour numbers key.
action requiredstringThe word getNumbersStatus.
countryintegerOnly this country.

Replies in JSON, keyed service_country: {"wa_41":"12"}.

GET or POSTaction=getPricesPrices and stock
ParameterTypeWhat it is
api_key requiredstringYour numbers key.
action requiredstringThe word getPrices.
countryintegerOnly this country.
servicestringOnly this service.

Replies in JSON: {"41":{"wa":{"cost":0.31,"count":12}}}.

GET or POSTaction=getNumberRent a number
ParameterTypeWhat it is
api_key requiredstringYour numbers key.
action requiredstringThe word getNumber.
service requiredstringService code, for example wa for WhatsApp, tg for Telegram.
countryintegerCountry id. Leave it out, empty, or send any for the cheapest anywhere.
maxPricedecimalRefuse a number above this price.

Replies ACCESS_NUMBER:880412:237650112233: the id first, then the number. Keep the id, every later call needs it.

GET or POSTaction=getStatusHas the code arrived?
ParameterTypeWhat it is
api_key requiredstringYour numbers key.
action requiredstringThe word getStatus.
id requiredintegerThe id from getNumber.

Replies STATUS_WAIT_CODE, then STATUS_OK:438201 when the code arrives, or STATUS_CANCEL if the rental ended.

GET or POSTaction=setStatusMove the rental on
ParameterTypeWhat it is
api_key requiredstringYour numbers key.
action requiredstringThe word setStatus.
id requiredintegerThe id from getNumber.
status requiredinteger1 ready, 3 ask for another code, 6 finish, 8 cancel and refund.

Replies ACCESS_READY, ACCESS_RETRY_GET, ACCESS_ACTIVATION or ACCESS_CANCEL.

A full rental, start to finish

A WhatsApp number in Cameroon
# 1. get a number
curl "https://kamiverify.com/api/v1?api_key=KEY&action=getNumber&service=wa&country=41"
# ACCESS_NUMBER:880412:237650112233

# 2. ask every 5 seconds
curl "https://kamiverify.com/api/v1?api_key=KEY&action=getStatus&id=880412"
# STATUS_WAIT_CODE
# STATUS_OK:438201

# 3. finish (or status=8 to cancel and be refunded)
curl "https://kamiverify.com/api/v1?api_key=KEY&action=setStatus&id=880412&status=6"
# ACCESS_ACTIVATION

Every reply v1 can give

ACCESS_NUMBER:id:phoneNumber issued. The id comes first.
STATUS_WAIT_CODENo code yet. Keep asking.
STATUS_OK:codeThe code arrived. Stop asking.
STATUS_CANCELCancelled, expired, or already finished.
ACCESS_READYstatus=1 accepted.
ACCESS_RETRY_GETstatus=3 accepted: another code requested.
ACCESS_ACTIVATIONstatus=6 accepted: rental closed.
ACCESS_CANCELstatus=8 accepted: refunded to your balance.

And every error

BAD_KEYMissing or wrong key, or the account is suspended.
BAD_ACTIONNo such action.
BAD_SERVICENo service was sent.
BAD_STATUSNot 1, 3, 6 or 8, or the rental has already ended.
NO_NUMBERSNothing in stock for that pair. Try another country.
NO_BALANCEAdd funds. Nothing was charged.
NO_ACTIVATIONThat id is not yours, or does not exist.
EARLY_CANCEL_DENIEDCancelled in the first two minutes. Wait, then try again.
ERROR_SQLWe could not record it. Nothing was charged.
Two rules that involve your money. A rental that never receives a code is refunded automatically after 20 minutes: you do not have to call setStatus at all. And a cancel in the first two minutes is refused, so that ordering and cancelling in a loop cannot be used to scan our stock.
Ask every 5 seconds, not every half second. Codes take seconds to minutes depending on the app. Asking faster does not make them arrive sooner.

v2 SMM services

Followers, views, likes and comments on the big platforms. You order by link and quantity, and you can read the progress while it runs.

Base URLhttps://kamiverify.com/api/v2always POST
This is the standard panel protocol, on purpose. The action names and reply keys are the ones SMM panel software expects. If you run a panel, you can very likely add KamiVerify as a provider by pasting this URL and your key into your provider screen: no adapter, no custom code.
POSTaction=servicesThe full catalogue with prices
ParameterTypeWhat it is
key requiredstringYour boosting key.
action requiredstringThe word services.
POSTaction=addPlace an order
ParameterTypeWhat it is
key requiredstringYour boosting key.
action requiredstringThe word add.
service requiredintegerService id from services.
link requiredstringThe post or profile link the order is for.
quantity requiredintegerHow many. Between the service minimum and maximum.
POSTaction=statusProgress of one order
ParameterTypeWhat it is
key requiredstringYour boosting key.
action requiredstringThe word status.
order requiredintegerThe order id returned by add.
POSTaction=ordersYour recent orders
ParameterTypeWhat it is
key requiredstringYour boosting key.
action requiredstringThe word orders.
limitintegerHow many, newest first. 100 by default, 300 at most.
POSTaction=multistatusUp to 100 orders in one call
ParameterTypeWhat it is
key requiredstringYour boosting key.
action requiredstringThe word multistatus.
orders requiredstringOrder ids separated by commas, 100 at most. status accepts this too. The reply is keyed by order id, and an unknown id gets its own error instead of failing the whole call.
Place an order and read it back
# place it
curl "https://kamiverify.com/api/v2" \
  -d "key=YOUR_SMM_KEY" -d "action=add" \
  -d "service=1043" \
  -d "link=https://instagram.com/p/Cx1y2z3" \
  -d "quantity=1000"
# {"order":238104}

# read it back
curl "https://kamiverify.com/api/v2" \
  -d "key=YOUR_SMM_KEY" -d "action=status" -d "order=238104"

# {"charge":"0.2700","start_count":"1240","status":"In progress","remains":"320","currency":"USD"}

Order statuses

PendingAccepted, not started yet.
In progressRunning. remains counts down.
CompletedDelivered in full.
PartialPart delivered. The rest is refunded to your balance automatically.
CanceledNot delivered. Refunded in full.
ProcessingBeing passed to the provider.

Errors

The two protocols report problems differently, each following its own standard. v1 replies with a bare word such as BAD_KEY: every one is listed in the v1 section. v2 replies in JSON, as below.

v2 errors come back as 200 OK with an error key, which is what panel software expects. Check for the key, not the HTTP status.

An error reply
{ "error": "Not enough balance" }
Incorrect API keyMissing, mistyped, or replaced since you saved it.
Not enough balanceAdd funds. Nothing was charged and no order was made.
Incorrect service IDThe service does not exist or is no longer sold.
Incorrect quantityBelow the service minimum or above its maximum.
Incorrect order IDNo such order, or it belongs to someone else.
The account is inactiveThe account is suspended. Contact support.
A timeout means unknown, not failed. If a call to add or getNumber times out, the order may still have been made and charged. Read it back with status before trying again, or you may pay twice for one order.

Rate limits

Nothing is throttled yet. The figures below are fair use, not enforced limits. Build to them anyway: they are what the limits will be when throttling starts, so your code will not need to change.
ActionGuidanceWhy
getStatus, status1 per second per orderAsk every 5 seconds. Faster does not bring codes sooner.
multistatus100 ids per callUse it instead of looping over single orders.
add, getNumber10 per secondPer account.
services1 per minuteThe catalogue barely moves. Keep a copy for an hour.

Reseller rules

Short, and we mean them.

  • Set your own prices. We bill you the API price. What you charge your customers is your business.
  • Your customers are yours. We never contact them and never see who they are, only the orders you place.
  • Support your own users first. If the problem turns out to be ours, bring it to us with the order id.
  • Lawful use only. Numbers are for receiving codes on accounts the user is entitled to open. Using them to impersonate people, take over accounts or commit fraud ends the account: yours, not only theirs.
  • Do not resell the key. One key, one business. Give your customers your own interface, not our credentials.

No contract, no minimum volume, no monthly fee. Stop whenever you like: what is left on your balance stays yours to spend.

Get your keys and start

Create an account, add funds, and place your first API order in a few minutes.