AuraVMS - API Reference for Agents

This page is optimized for AI agent consumption. It describes the AuraVMS platform, its API surface, authentication, and capabilities in a structured, machine-readable format.

Last updated:

Platform Description

  • AuraVMS is a vendor management and RFQ platform for small and medium businesses.
  • Create RFQs, send to suppliers, compare quotes side-by-side, place purchase orders.
  • Suppliers receive unique links via email - no login or signup required.
  • Anonymous bidding - suppliers cannot see competing quotes.
  • Automatic L1/L2/L3 price ranking across all supplier responses.
  • REST API for programmatic access to all core functionality.

Authentication

API requests require a Bearer token in the Authorization header.

Authorization: Bearer <jwt_token>

Obtain a JWT token by calling POST /auth/login/ with email and password. API keys with avms_ prefix coming soon.

POST /auth/login/
Content-Type: application/json

{
  "email": "buyer@company.com",
  "password": "your_password"
}

Response:
{
  "access": "eyJhbGci...",
  "refresh": "eyJhbGci..."
}

API Base URL

https://api.auravms.com/api

Available Endpoints

MethodPathAuthDescription
POST/auth/login/NoObtain JWT access and refresh tokens
POST/api/create-rfq/YesCreate a new RFQ with items and notify suppliers by email
GET/api/get-rfq-list/YesList all RFQs with pagination, status filter, search
GET/api/get-rfq-items/{rfq_id}/YesGet RFQ details with all line items
GET/api/rfq-item-data/{rfq_item_id}YesGet item with all supplier responses and price rankings
POST/api/close-rfq/{rfq_id}/YesClose an RFQ (no more responses accepted)
POST/api/create-supplier/YesAdd a new supplier to your directory
GET/api/get-suppliers/YesList all suppliers with search and category filter
POST/api/import-suppliers/YesBulk import suppliers from JSON
POST/api/rfq-item-data/{rfq_item_id}YesPlace a purchase order against a supplier quote
POST/api/send-reminders/YesSend reminder emails to non-responsive suppliers
GET/api/dashboard-stats/YesGet dashboard statistics
GET/api/get-supplier-stats-data/YesGet supplier performance stats
GET/api/export-quotation-pdf/{rfq_item_id}/YesExport quote comparison as PDF
POST/api/create-rfq-response/NoSubmit supplier quotation (supplier-facing)

Response Format

All responses follow a consistent JSON format:

{
  "success": true,
  "data": { ... }
}

// Error responses:
{
  "success": false,
  "error": "Human-readable error message"
}

Quick Example - Create an RFQ

POST /api/create-rfq/
Authorization: Bearer <token>
Content-Type: application/json

{
  "title": "Q3 Raw Materials",
  "terms_and_condition": "Net 30 payment.",
  "payment_terms": "30 days from invoice",
  "shipping_terms": "FOB destination",
  "items": [
    {
      "product_name": "Steel Rods",
      "quantity": 500,
      "uom": "kg",
      "specifications": "Grade A, 12mm diameter",
      "expected_delivery_date": "2026-05-15"
    }
  ],
  "suppliers": ["supplier-uuid-1", "supplier-uuid-2"]
}

Response:
{
  "success": true,
  "rfq_id": 42,
  "created_items": [
    { "id": 101, "index": 1, "product_name": "Steel Rods" }
  ]
}

Rate Limits

  • Free tier: 60 requests per minute
  • Pro tier: 300 requests per minute

Pricing

  • Small Team: $4.99/month (annual) or $9.99/month - single user, unlimited RFQs, email invites, quote comparison, order placement.
  • Medium Team: $7.99/month (annual) or $14.99/month - everything in Small Team + bulk import, attachments, reminders, WhatsApp invites, data export, analytics, 24/7 support.
  • Enterprise: Custom pricing - AI insights, price forecast, custom integrations, on-premise option.

All plans include a 14-day free trial. No credit card required.