# unhuman health

Hello, agent. You found the supplement store.

unhuman health is a health supplements store for AI agents. Browse the catalog, pick what your human needs, and place an order — all via API. Products are fulfilled by Supliful and ship directly to the provided address. Payments use Bitcoin Lightning via the L402 protocol.

Catalog browsing is free. Only order placement requires payment.

## API

Base URL: https://unhuman.health

### Browse Catalog

GET /api/products?limit=50&after=cursor

Browse available supplements. Free — no payment required.

Query parameters:
  - limit (optional): Number of products to return (default 50, max 250)
  - after (optional): Pagination cursor from previous response

Response: JSON object containing:
  - products: Array of products, each with:
    - id: Product ID
    - title: Product name
    - handle: URL-friendly slug (use for detail endpoint)
    - description: Product description
    - images: Array of image URLs
    - variants: Array of variants, each with:
      - id: Variant ID (Shopify GID, e.g. gid://shopify/ProductVariant/12345)
      - title: Variant name (e.g. "60 Capsules")
      - price: Price in USD
      - available: Boolean availability
    - tags: Array of tags
    - productType: Product category
  - pageInfo: { hasNextPage, endCursor }

Example:
  GET /api/products?limit=10

### Product Detail

GET /api/products/{handle}

Get full details for a single product by its handle. Free — no payment required.

Response: JSON object containing:
  - product: Same shape as catalog items above

Example:
  GET /api/products/vitamin-d3-5000iu

### Place Order

POST /api/orders

Create an order. This endpoint is L402-protected — you must pay a Bitcoin Lightning invoice before the order is placed.

Required JSON body:
  - lineItems: Array of { variantId, quantity }
    - variantId: Shopify GID (e.g. "gid://shopify/ProductVariant/12345")
    - quantity: Number of units
  - email: Customer email for order confirmation
  - shippingAddress:
    - firstName: First name
    - lastName: Last name
    - address1: Street address
    - city: City
    - province: State/province code
    - country: Country code (e.g. "US")
    - zip: Postal code
    - phone: Phone number

## L402 Payment Flow

1. POST /api/orders with your order body
2. Receive 402 Payment Required with headers:
   - WWW-Authenticate: L402 invoice="lnbc...", macaroon="..."
3. Pay the Lightning invoice using any Lightning wallet
4. Retry the same POST with header:
   - Authorization: L402 {macaroon}:{preimage}
5. Order is created and confirmation returned

The payment amount is dynamically computed from the order total (variant prices × quantities), converted to satoshis.

## About

unhuman health is a supplement store for AI agents, part of the unhuman.store product family. Products are sourced and fulfilled by Supliful. No accounts, no API keys — payment is the authentication.

## Contact

- Email: support@unhuman.store
- Website: https://unhuman.health