Unshared KV API Documentation

Unified API for KV (KeyVault) validation, shared detection, and rarity checking.

Quick Test

Response will appear here...

📡 Endpoints

GET /api/?action=info&id={serial}

Public endpoint - Check if a KV is shared and get info

Parameter	Type	Description
id *	string	12-character KV serial
status	int	Optional: 1=unbanned, 2=banned (logs the check)

{"shared":false,"info":{"id":"000000000000","amount":0,"status":"1","timestamp":"Just Now","from_us":false,"logged":false}}

POST /api/?action=check

Check KV shared status (used by validator)

Parameter	Type	Description
id *	string	12-character KV serial
status	int	1=unbanned, 2=banned

GET /api/?action=rarity&date={MM-DD-YY}

Get KV rarity based on manufacturing date

Parameter	Type	Description
date *	string	Date in MM-DD-YY format

{"success":true,"rarity":"Common","production":"8M","console":"Phat (Jasper)"}

POST /api/?action=validate

Validate a KV file (multipart form upload)

Parameter	Type	Description
file *	file	KV .bin file (16384 bytes)

POST /api/?action=store

Store KV data in session

GET /api/?action=data&type={view|dl}

Get or download stored session data

🔐 Authentication Endpoints

POST /api/?action=login

Authenticate with username/password to get API token

Parameter	Type	Description
username *	string	Account username
password *	string	Account password

{"success":true,"user":{"id":1,"username":"example","email":"user@example.com","level":1},"api_token":"abc123..."}

GET /api/?action=profile

Get authenticated user's profile (requires token)

Header/Param	Type	Description
Authorization	header	Bearer {api_token}
api_token	string	Alternative: pass token as parameter

POST /api/?action=regenerate_token

Generate a new API token (requires authentication)

📦 Downloads & Purchases

GET /api/?action=downloads

Get list of user's purchased downloads (requires token)

{"success":true,"count":2,"purchases":[{"transaction_id":"TXN123","product_name":"KV","download_url":"/api/?action=download&token=..."}]}

GET /api/?action=download&token={token}&txn={txn_id}

Download a purchased file (requires token)

Parameter	Type	Description
token *	string	Download token from purchases list
txn *	string	Transaction ID

GET /api/?action=products

Get available products (public)

🔑 Authentication Methods

Pass your API token using one of these methods:

🔗 Legacy Support

The following legacy endpoints are still supported for backward compatibility: