Developer Documentation v1.0

Wholesale REST API Reference

The Yunizo Labs Wholesale API provides direct programmatic access to verified digital subscriptions, real-time inventory synchronization, balance inquiries, and automated license provisioning for resellers and platforms.

API Key Provisioning & Verification Workflow

1Request API Access

Navigate to your Developer Portal and generate a production API key using your verified WhatsApp contact.

2Pending Verification

For security and wholesale protection, new keys are created in Pending status with masked credentials.

3Administrative Activation

Our operations team verifies your reseller account and activates your key. Once verified, full production requests and unmasked keys become available immediately.

Global Request Specifications

Base URL: https://yunizolabs.shop/api/v1

Authentication: Provide your API key via Authorization: Bearer sk-YOUR_API_KEY or X-API-Key: sk-YOUR_API_KEY (Standard format: sk-xxxxxxxx...)

API Endpoints
HTTP Response Codes
200 OK - Request completed successfully
400 Bad Request - Missing or invalid parameters
401 Unauthorized - Invalid or missing API key
402 Payment Required - Insufficient wallet balance
403 Forbidden - Key is pending approval or suspended
429 Too Many Requests - Rate limit exceeded (Configurable / Default Unlimited)
503 Service Unavailable - Gateway under scheduled maintenance
Endpoint Request

GET /api/v1/services

curl -X GET "https://yunizolabs.shop/api/v1/services" \
  -H "Authorization: Bearer sk-YOUR_API_KEY"
Endpoint Description & Business Logic
💱 Multi-Currency Support:Pass query parameter ?currency=USD or X-Currency: USD header to receive rates and balances in US Dollars ($) converted via the official platform exchange rate configured in Admin Settings. Defaults to Pakistani Rupees (PKR).

Returns the comprehensive catalog of active digital services. Each record contains the verified product name, category, official store description, product image URL, delivery type, and wholesale price. If authenticated, assigned negotiated client rates automatically override standard catalog pricing.

Standard JSON Response
{
  "status": "success",
  "count": 132,
  "currency": "PKR",
  "exchange_rate_usd_to_pkr": 290,
  "authenticated": true,
  "client_name": "Authorized Reseller",
  "services": [
    {
      "service_id": 168,
      "name": "younis testing",
      "category": "AI Tools",
      "rate": 1500,
      "currency": "PKR",
      "formatted_rate": "PKR 1,500",
      "rate_pkr": 1500,
      "rate_usd": 5.17,
      "is_custom_priced": false,
      "stock_status": "in_stock",
      "available_units": 15,
      "min_quantity": 1,
      "max_quantity": 15,
      "delivery_type": "instant",
      "instant_delivery": true,
      "duration": "1 Month",
      "warranty": "30 Days Full Coverage",
      "description": "Official Developer Test Product with verified instant automated credential delivery.",
      "full_description": "Official Developer Sandbox & Live Integration Test Product for Yunizo Labs Wholesale API. Designed for developers and resellers to test automated order provisioning, balance deductions, real-time stock checks, and instant credential delivery.",
      "image_url": "/logo.png",
      "features": [
        "Instant Automated Credential Provisioning",
        "Full 30-Day Warranty Coverage",
        "REST API Integration Verified",
        "Direct Private Profile Access"
      ],
      "faq": [
        {
          "question": "How are test credentials delivered?",
          "answer": "Test credentials are delivered immediately in the API response delivery.data field and logged in your order history."
        },
        {
          "question": "What is the wholesale rate for API resellers?",
          "answer": "Resellers get the wholesale rate configured by admin (PKR 1,500)."
        }
      ]
    }
  ]
}