API Reference

Overview

The AI POS API gives you programmatic access to products, sales, customers, and inventory data. All endpoints return JSON responses and require bearer token authentication.

REST API

Standard HTTP verbs

JSON

Request & response format

OAuth 2.0

Secure authentication

Rate Limited

1000 req/min

Authentication

All API requests require a bearer token in the Authorization header. Get your API key from the dashboard under Settings → API Keys.

                            // Authenticate via Header
curl -X GET https://sbstechnologies.in/aipos/api/v1/products \
  -H "Authorization: Bearer YOUR_API_KEY"
                        

                            const aipos = require('@aipos/sdk');
const client = new aipos.Client({ apiKey: 'YOUR_API_KEY' });
                        

                            import aipos
client = aipos.Client(api_key='YOUR_API_KEY')
                        

Base URL

https://sbstechnologies.in/aipos/api/v1

All endpoints are versioned. The current stable version is v1.

Endpoints

Products

                    GET    /products          // List all products
GET    /products/:id      // Get product by ID
POST   /products          // Create product
                

Sales & Bills

                    GET    /sales             // List all sales
POST   /sales             // Create new sale
GET    /sales/:id/receipt // Download PDF
                

Example: Create a Sale

                            // Send a POST request
curl -X POST https://sbstechnologies.in/aipos/api/v1/sales \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "customer_id": "cust_abc123",
    "items": [{ "product_id": "prod_001", "qty": 2, "price": 45.00 }],
    "payment_method": "upi"
  }'
                        

                            await client.sales.create({
  customerId: 'cust_abc123',
  items: [{ productId: 'prod_001', qty: 2, price: 45.00 }],
  paymentMethod: 'upi'
});
                        

                            client.sales.create(
    customer_id='cust_abc123',
    items=[{'product_id': 'prod_001', 'qty': 2, 'price': 45.00}],
    payment_method='upi'
)
                        

Sample Response (201 Created)

                    {
  "id": "sale_xyz789",
  "total": 102.50,
  "tax": 5.13,
  "grand_total": 107.63,
  "created_at": "2026-03-31T10:30:00Z"
}
                

Webhooks

Subscribe to real-time events for your integration. Configure webhook URLs from the dashboard.

                    // Available webhook events:
sale.created        // New sale completed
sale.refunded       // Sale refunded
product.created     // New product added
product.updated     // Product details changed
inventory.low       // Stock below threshold
sync.completed      // Cloud sync finished
                

SDKs & Libraries

Node.js

npm i @aipos/sdk

Python

pip install aipos

Java / Kotlin

Maven Central