API Calls

Base: https://api.g3nretailstack.com/uas

Source of truth: /internal-docs/uas-openapi.yaml → /uas/openapi.yaml

Notes: samples are schema-derived placeholders. Replace placeholder values (ORGCODE, SESSION_GUID, etc.) with real values.

Inventory

Method	Path	Summary	Request schema	Response schema
POST	/stat	Fetch a user snapshot (email + passcode)	UasStatRequest	UasStatSuccess

Call details

POST /stat

Purpose: Fetch a user snapshot (email + passcode)

Notes: Returns a user snapshot envelope. Notes: - Requires email + passcode (API Gateway). - On success, revision is the current revision of the user record. - session_guid is not accepted/required on this surface and is never emitted. - Invalid credentials return 401 without disclosing whether the email exists.

Request schema: UasStatRequest Response schema: UasStatSuccess

Sample request (schema-derived)

{
  "email": "user@example.com",
  "passcode": "CODE1"
}

Sample response (shape-only)

{
  "success": true,
  "data": {
    "user_id": "USER_ID",
    "account_ref": "string",
    "status": "active",
    "caption": "Example caption",
    "created_at": "2026-01-01T00:00:00Z",
    "updated_at": "2026-01-01T00:00:00Z",
    "emails": [
      {
        "email": "user@example.com",
        "status": "active",
        "is_primary": false,
        "created_at": "2026-01-01T00:00:00Z",
        "updated_at": "2026-01-01T00:00:00Z"
      }
    ],
    "passcode": {
      "set": false
    },
    "payment_methods": [
      {
        "pm_id": "string",
        "processor": "string",
        "token_type": "string",
        "status": "active",
        "priority": 0,
        "created_at": "2026-01-01T00:00:00Z",
        "updated_at": "2026-01-01T00:00:00Z"
      }
    ]
  },
  "build": {
    "build_id": "MONDAY-0000000000"
  },
  "stats": {
    "call": "POST /stat",
    "service": "uas",
    "timestamp_utc": "2026-01-01T00:00:00Z"
  }
}