ArmorVault Vendor API

Quickstart Guide — Get your deals on ArmorVaultLive.com in minutes

1. Authentication

Include your API key in every request as an x-api-key header:

x-api-key: avl_your_api_key_here

2. Submit a Single Deal

POST /api/v1/deals 
curl -X POST https://api.armorvaultlive.com/api/v1/deals \
  -H "Content-Type: application/json" \
  -H "x-api-key: avl_your_api_key_here" \
  -d '{
    "title": "Glock 19 Gen 5 MOS 9mm",
    "sku": "GLOCK-19-G5-MOS",
    "category": "handgun",
    "price": 549.99,
    "msrp": 599.99,
    "url": "https://yourstore.com/glock-19-gen5",
    "image_url": "https://yourstore.com/images/glock19.jpg",
    "caliber": "9mm",
    "brand": "Glock",
    "in_stock": true,
    "quantity_available": 15,
    "description": "Glock 19 Gen 5 MOS 9mm 15+1 4.02in"
  }'

Required Fields

FieldTypeDescription
titlestringProduct name
pricenumberCurrent sale price
urlstringDirect product page URL
image_urlstringProduct image URL (JPEG/PNG/WebP)
skustringYour product SKU (used for upsert deduplication)
categorystringhandgun, rifle, shotgun, ammo, optic, suppressor, holster, magazine, light, sling, accessory
msrpnumberManufacturer suggested retail price
caliberstringe.g., "9mm", "5.56 NATO", "12 Gauge"
brandstringManufacturer name
in_stockbooleanDefaults to true
quantity_availableintegerStock count
sale_endsstringISO date when the deal expires
descriptionstringProduct description

3. Bulk Upload (up to 5,000 products)

POST /api/v1/feeds 
curl -X POST https://api.armorvaultlive.com/api/v1/feeds \
  -H "Content-Type: application/json" \
  -H "x-api-key: avl_your_api_key_here" \
  -d '{
    "products": [
      { "title": "Sig P365 9mm", "price": 499.99, "url": "https://yourstore.com/p365", "sku": "SIG-P365", "category": "handgun" },
      { "title": "Federal 9mm 115gr FMJ 50rd", "price": 14.99, "url": "https://yourstore.com/9mm-50", "sku": "FED-9MM-50", "category": "ammo" }
    ]
  }'

The bulk endpoint accepts flexible field names. Common alternatives like name, product_name, sale_price, product_url, buy_url are all recognized.

4. Remove a Deal

DELETE /api/v1/deals/:sku 
curl -X DELETE https://api.armorvaultlive.com/api/v1/deals/GLOCK-19-G5-MOS \
  -H "x-api-key: avl_your_api_key_here"

5. View Your Deals

GET /api/v1/deals?merchant_id=YOUR_ID

Filter the public deals list by your merchant ID to see your approved, in-stock listings.

6. Deal Review Process

Note: New merchant accounts start with manual review enabled. Your deals will appear with status "pending" until approved by our team (usually within 24 hours). Once we verify your inventory feed quality, we can enable auto-approval for faster listing.

7. Categories

Use one of these category values for best classification results:

handgun, rifle, shotgun, ammo, optic, suppressor, holster, magazine, light, sling, accessory

If omitted or unrecognized, our classification engine will attempt to categorize based on the product title.

8. Rate Limits

100 requests per 15 minutes across all API endpoints. The bulk /api/v1/feeds endpoint counts as 1 request regardless of how many products you include (up to 5,000).

9. Need Help?

Email support@armorvaultlive.com

ArmorVaultLive.com