Menu Navigation
Browse Shop
Account Dashboard
Your Profile
Account Settings
My Orders
Balance History
Transfer Money
Top Up Balance
Quick Links
Our Blog
Contact Us
API Docs
Create account Already a Member?
Secure Marketplace

© 2026 Buy PVA Accounts. High quality digital assets delivered instantly.

Developer API

A clean REST API to integrate the Buy PVA marketplace — browse products, place orders, and manage your account programmatically.

Base URL https://api.buypvaacc.com/api/v1

Overview

All API responses are returned as JSON. Public endpoints are open to all users, while protected endpoints require your unique API Key to be passed in the Authorization header.

Request Headers
Authorization: Bearer YOUR_API_KEY
Accept: application/json
Content-Type: application/json

Authentication

Retrieve your API key from the dashboard (requires login). Pass it in the Authorization header on every protected request.

Security First: Your API keys are strictly for your account's use. If you suspect your key has been compromised, rotate it immediately in your account settings.

Manage Your API Key

You can view and rotate your API key in your Account Settings.

Go to Settings

You must be signed in to manage API keys.

Public Endpoints
GET /categories

Returns all active top-level categories, including their sellers and each seller's products.

🔓 No authentication required.

Example Request
curl -X GET "[BASE_URL]/categories" \
  -H "Accept: application/json"
200 Response
{
  "data": [
    {
      "id": 1,
      "name": "Gmail Accounts",
      "slug": "gmail-accounts"
    },
    {
      "id": 2,
      "name": "Instagram Accounts",
      "slug": "instagram-accounts"
    }
  ]
}
GET /products?category_id={id}

Returns all active products for a specific category (by ID or slug). Results are not paginated when filtered by category.

🔓 No authentication required.

ParameterTypeDescription
category_idintegerFilter by category ID
category_slugstringFilter by category slug (e.g. gmail-accounts)
sortstringnewest · oldest · price_asc · price_desc
Example Request — by ID
curl "[BASE_URL]/products?category_id=1" \
  -H "Accept: application/json"
Example Request — by Slug
curl "[BASE_URL]/products?category_slug=gmail-accounts" \
  -H "Accept: application/json"
200 Response
{
  "data": [
    {
      "product_id": 12,
      "name": "Gmail PVA – Aged 1yr",
      "description": "Phone verified Gmail accounts, 1 year old.",
      "price": "1.50",
      "type": "stock",
      "stock_count": 48,
      "seller_id": 5,
      "seller_name": "DigitalStore"
    },
    {
      "product_id": 14,
      "name": "Gmail Bulk – 10 Pack",
      "price": "12.00",
      "type": "non_stock",
      "seller_id": 5,
      "seller_name": "DigitalStore"
    }
  ]
}
GET /products/{id}

Returns the full detail for a single active product.

🔓 No authentication required.

Example Request
curl "[BASE_URL]/products/12" \
  -H "Accept: application/json"
200 Response
{
  "data": {
    "product_id": 12,
    "name": "Gmail PVA – Aged 1yr",
    "price": "1.50",
    "type": "stock",
    "stock_count": 48,
    "seller_name": "DigitalStore",
    "category": {
      "category_id": 1,
      "name": "Gmail Accounts",
      "slug": "gmail-accounts"
    }
  }
}
Authenticated Endpoints
POST /orders

Place a new order. Balance is deducted from your account wallet automatically.

🔐 Requires API Key.

Example Request
curl -X POST "[BASE_URL]/orders" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -d '{"product_id": 12, "quantity": 1}"'
Request Body
{
  "product_id": 12,
  "quantity": 2
}
201 Response
{
  "status": "success",
  "message": "Order placed successfully.",
  "data": {
    "order_id": 88,
    "product_id": 12,
    "quantity": 2,
    "total_amount": "3.00",
    "status": "paid",
    "delivery_data": "[email protected]:pass1\[email protected]:pass2"
  }
}
GET /orders/{id}

Fetch details of a specific order. You can only access orders that belong to your account.

🔐 Requires API Key.

Example Request
curl "[BASE_URL]/orders/88" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Accept: application/json"
200 Response
{
  "data": {
    "id": 88,
    "product_id": 12,
    "quantity": 2,
    "price": 3.00,
    "status": "paid",
    "delivery_data": "[email protected]:pass1\[email protected]:pass2",
    "variant_name": "Premium High Proxy"
  }
}
GET /balance

Returns the current wallet balance for the authenticated user.

🔐 Requires API Key.

Example Request
curl "[BASE_URL]/balance" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Accept: application/json"
200 Response
{
  "balance": "12.50"
}