API Documentation | Caryvn Developer & Reseller REST API v2

POSTaction=services

List Services

Returns all active SMM services available on Caryvn in standard SMM Panel v2 format. Rates are formatted per 1,000 units in Nigerian Naira (NGN).

Request Parameters

Parameter	Type	Status	Description
key	string	Required	Your account API key.
action	string	Required	Must be "services".

Example Request (CURL)

curl

curl -X POST "https://www.caryvn.com/api/v2/" \
  -H "Content-Type: application/x-www-form-urlencoded" \
  -d "key=YOUR_API_KEY" \
  -d "action=services"

Example Response (JSON)

json

[
  {
    "service": 1,
    "name": "Instagram Followers [High Quality - Non Drop]",
    "type": "Default",
    "category": "Instagram Followers",
    "rate": "1500.00",
    "min": "50",
    "max": "50000",
    "refill": true,
    "cancel": false,
    "description": "High retention authentic followers. Starts within 5-15 mins.",
    "average_time": "12 minutes"
  },
  {
    "service": 42,
    "name": "TikTok Likes [Instant - Real Accounts]",
    "type": "Default",
    "category": "TikTok Likes",
    "rate": "850.00",
    "min": "100",
    "max": "100000",
    "refill": false,
    "cancel": false,
    "description": "Instant delivery. Safe for all video types.",
    "average_time": "4 minutes"
  }
]

Authentication & Security

Caryvn’s Reseller API requires authentication via your account’s unique API key. Every request to /api/v2/ must include key=YOUR_API_KEY in the URL-encoded POST payload.

Security Guidelines:

Never expose your API key in client-side code (mobile apps or browser scripts).
Always route calls through your own secure backend server.
If your key is compromised, regenerate a new one anytime in Account Settings.

Currency & Pricing Policy

All services on Caryvn operate natively in Nigerian Naira (NGN - ₦).

Rate Format

Rates returned in action=services indicate the price per 1,000 units in NGN.

Automatic Partial Refunds

If an order is canceled or partially completed, unfulfilled units are refunded back to your wallet balance automatically.

Virtual Numbers & SMS Verification

Looking to acquire virtual phone numbers for SMS OTP verification? Caryvn provides instant temporary virtual numbers for WhatsApp, Telegram, Google, OpenAI, TikTok, and 500+ services.

Interactive OTP Dashboard Active

Rent numbers with real-time SMS stream and 100% auto-refund guarantee.

Open OTP Hub

Error Codes Reference

When a request fails, the API responds with a non-200 HTTP status code and a JSON payload containing an error message.

HTTP Code	Error Message	Resolution
401	Invalid API key.	API key is missing, incorrect, or disabled.
400	Missing required parameter: service	The service parameter was omitted from action=add.
400	Parameter "link" must be a valid http:// or https:// URL	The destination link is malformed or missing scheme.
400	Minimum quantity for this service is X	Quantity requested is below the required threshold.
400	Maximum quantity for this service is X	Quantity requested exceeds the upper limit for this service.
400	Insufficient balance.	Your NGN wallet balance is lower than the order cost.
400	You already have an active order for this link + service combination.	Duplicate order lock. Wait for current order to complete.
400	This service does not support refills	Refill requested for an order whose service has refill=false.
400	Order must be completed before requesting a refill	Refill requested before the order reached Completed status.
429	Too many requests. Please wait a moment...	Rate limit exceeded (max 200 requests/minute per key).

Rate Limits & Concurrency Locks

200 Requests / Minute

API calls are throttled to 200 requests per minute per API key. If exceeded, HTTP 429 is returned. Implement exponential backoff for resilience.

Concurrency Lock

Orders for the exact same service and destination link cannot be placed while an earlier order is still active, protecting against duplicate charges.

Developer & Reseller API Documentation

Want to automate with Caryvn?