API v1.0 - Stable
API Documentation
Integrate POS, accounting, and inventory management
into your applications with the Seisei API
99.9%
API Uptime
<100ms
Avg Response Time
50+
Endpoints
6
Official SDKs
Quick Start
1
Get Your API Key
Access developer settings from your dashboard and generate an API key.
Request API Key →2
Set Up Authentication
Include Bearer authentication header in all API requests.
// API Key Authentication
const response = await fetch('https://api.seisei.tokyo/v1/orders', {
headers: {
'Authorization': 'Bearer YOUR_API_KEY',
'Content-Type': 'application/json'
}
});3
Make Your First API Call
Example: Fetching orders list
// Get orders list
const response = await fetch('https://api.seisei.tokyo/v1/orders?limit=10&status=completed', {
headers: {
'Authorization': 'Bearer YOUR_API_KEY'
}
});
const orders = await response.json();
console.log(orders.data);API Endpoints
🛒
POS API
Sales and order management API
| Method | Endpoint | Description |
|---|---|---|
| GET | /api/v1/orders | List all orders |
| POST | /api/v1/orders | Create a new order |
| GET | /api/v1/orders/{id} | Get order details |
| PUT | /api/v1/orders/{id} | Update an order |
| DELETE | /api/v1/orders/{id} | Cancel an order |
💰
Accounting API
Accounting and financial processing API
| Method | Endpoint | Description |
|---|---|---|
| GET | /api/v1/invoices | List all invoices |
| POST | /api/v1/invoices | Create an invoice |
| GET | /api/v1/transactions | Get transaction history |
| POST | /api/v1/payments | Record a payment |
| GET | /api/v1/reports/financial | Get financial reports |
📦
Inventory API
Inventory management API
| Method | Endpoint | Description |
|---|---|---|
| GET | /api/v1/inventory | List inventory items |
| PUT | /api/v1/inventory/{id} | Update stock quantity |
| POST | /api/v1/inventory/adjust | Perform stock adjustment |
| GET | /api/v1/products | List all products |
| POST | /api/v1/products | Create a product |
👥
Customer API
Customer management API
| Method | Endpoint | Description |
|---|---|---|
| GET | /api/v1/customers | List all customers |
| POST | /api/v1/customers | Create a customer |
| GET | /api/v1/customers/{id} | Get customer details |
| PUT | /api/v1/customers/{id} | Update customer info |
| GET | /api/v1/customers/{id}/history | Get purchase history |
📊
Reports API
Analytics and reporting API
| Method | Endpoint | Description |
|---|---|---|
| GET | /api/v1/reports/sales | Get sales reports |
| GET | /api/v1/reports/inventory | Get inventory reports |
| GET | /api/v1/analytics/dashboard | Dashboard data |
| GET | /api/v1/analytics/trends | Trend analysis data |
Code Examples
Create an Order
// Create a new order
const newOrder = {
customer_id: 'cus_123456',
items: [
{ product_id: 'prod_001', quantity: 2, price: 1500 },
{ product_id: 'prod_002', quantity: 1, price: 2000 }
],
payment_method: 'credit_card'
};
const response = await fetch('https://api.seisei.tokyo/v1/orders', {
method: 'POST',
headers: {
'Authorization': 'Bearer YOUR_API_KEY',
'Content-Type': 'application/json'
},
body: JSON.stringify(newOrder)
});Handle Webhook Events
// Handle Webhook Events
app.post('/webhook', (req, res) => {
const event = req.body;
switch (event.type) {
case 'order.created':
handleNewOrder(event.data);
break;
case 'payment.completed':
handlePayment(event.data);
break;
case 'inventory.low':
handleLowInventory(event.data);
break;
}
res.status(200).send('OK');
});Official SDKs
Integrate Seisei with your preferred programming language
Error Codes
| Code | Name | Description |
|---|---|---|
| 400 | Bad Request | Invalid request format |
| 401 | Unauthorized | Authentication failed |
| 403 | Forbidden | Access denied |
| 404 | Not Found | Resource not found |
| 429 | Rate Limited | Request limit exceeded |
| 500 | Server Error | Internal server error |
Rate Limiting
Standard Plan
- • 1,000 requests/minute
- • 100,000 requests/day
- • Concurrent connections: 10
Enterprise Plan
- • 10,000 requests/minute
- • Unlimited requests/day
- • Concurrent connections: Unlimited
💡 When rate limited, a 429 Too Many Requests error is returned. Check the Retry-After header for the wait time before retrying.
Start Building Today
Test the API with our free sandbox environment.
Easy migration to production when ready.