Documentation

Developer-first. Optical-native.

Ship integrations in hours — not quarters. Every endpoint, every event, every machine.

⌘ K

Getting Started

Concepts, tenants, roles and your first workflow.

OpenAPI 3.1 · REST endpoints for every resource.

OAuth 2.1, JWT and API keys.

Signed webhooks with retries and replay.

LDS Specification

LDS 4.1 schema, values and machine mappings.

Machine Integration

Adapters, drivers and configuration.

TypeScript, Python, Go and Java.

Reference implementations and cookbooks.

API

Create an order in seconds.

POST /api/v1/orders

Create an order with a full prescription, lens and frame selection. The response returns an order id, LDS job file id and predicted ETA.

Response codes

201 Created

400 Validation failed

401 Unauthorized

create-order.http

POST /api/v1/orders
Authorization: Bearer $JD_API_KEY
Content-Type: application/json

{
  "customerId": "cust_9241",
  "prescription": {
    "od": { "sph": -3.25, "cyl": -0.75, "axis": 178, "add": 2.0 },
    "os": { "sph": -3.00, "cyl": -0.50, "axis": 170, "add": 2.0 },
    "pd": [32.5, 32.5]
  },
  "lens":  { "design": "PAL-Freeform", "index": 1.67, "coating": ["AR", "BlueCut"] },
  "frame": { "sku": "FRM-TT-071" }
}