Aetheria Developers Hub

API Reference Docs

Integrate Aetheria directly into your proprietary services, CRM triggers, or WooCommerce/Shopify pipelines.

Base URL

https://api.aetheria.solutions/v1

Authentication

Authenticate requests using a Bearer JWT Token. Log in using `/auth/login` to retrieve your key, then pass it inside the headers for secured resources:

Authorization: Bearer <YOUR_JWT_TOKEN>

Format Protocols

All request parameters must be formatted in valid UTF-8 JSON. Every API output contains a root `success` boolean parameter signaling completion.

Endpoints

POST/auth/login
Authenticate a user and retrieve a JWT session token.
Request Payload
{
  "email": "user@example.com",
  "code": "12345678"
}
Response Object
{
  "success": true,
  "token": "eyJhbGciOiJIUzI1NiIsIn...",
  "user": {
    "id": "8f8b7e2a-...",
    "email": "user@example.com",
    "role": "user"
  }
}
GET/organizations
Retrieve a list of organizations associated with the authenticated account.
Request Payload
None (Query params supported: limit, offset)
Response Object
{
  "success": true,
  "organizations": [
    {
      "id": "c1f7b8e3-...",
      "name": "Acme Corp",
      "slug": "acme-corp",
      "createdAt": "2026-05-20T12:00:00Z"
    }
  ]
}
POST/demo/request
Programmatically request a new trial/demo sandbox environment.
Request Payload
{
  "fullName": "Jane Doe",
  "email": "jane@acme.com",
  "companyName": "Acme Corp",
  "productId": "4f8b7e2a-...",
  "useCase": "Testing retail POS scale"
}
Response Object
{
  "success": true,
  "requestId": "d98b7e2a-...",
  "status": "pending",
  "message": "Demo request recorded successfully"
}