Developer API Marketplace

Exchange client credentials for a JWT access token. Tokens expire in 3600 seconds.

{"client_id": "string", "client_secret": "string", "grant_type": "client_credentials"}

Response 200:

{"access_token": "eyJhbGciOiJSUzI1NiIs...", "token_type": "Bearer", "expires_in": 3600, "scope": "read write"}

{"refresh_token": "string"}

Response 200:

{"access_token": "eyJhbGci...", "refresh_token": "dGhpcyBpcy...", "expires_in": 3600}

{"token": "string"}

Response 204: No content

Query params: page per_page role search

Response 200:

{"data": [{"id": "usr_8x7k2m", "email": "jane@example.com", "name": "Jane Doe", "role": "admin", "created_at": "2026-01-15T10:30:00Z"}], "pagination": {"page": 1, "per_page": 20, "total": 142, "total_pages": 8}}

{"email": "string", "name": "string", "role": "member|admin", "teams": ["string"]}

Response 201:

{"id": "usr_9z3q1n", "email": "bob@example.com", "name": "Bob Smith", "role": "member", "created_at": "2026-07-22T09:00:00Z"}

Path param: id — User ID (e.g. usr_8x7k2m)

{"id": "usr_8x7k2m", "email": "jane@example.com", "name": "Jane Doe", "role": "admin", "teams": ["eng", "ops"], "last_login": "2026-07-21T14:22:00Z"}

{"name": "string", "role": "member|admin", "teams": ["string"]}

{"id": "usr_8x7k2m", "name": "Jane D.", "role": "admin", "updated_at": "2026-07-22T09:00:00Z"}

Response 204: No content

Query: category min_price max_price in_stock sort page

{"data": [{"id": "prod_4k8j2n", "name": "Wireless Headphones X1", "price": 7999, "currency": "usd", "category": "electronics", "in_stock": true, "variants": 3}], "pagination": {"page": 1, "total": 856}}

{"name": "string", "price": 0, "currency": "usd", "category": "string", "description": "string", "variants": [{"name": "string", "sku": "string", "stock": 0}]}

{"id": "prod_7m3x9p", "name": "USB-C Hub Pro", "price": 4999, "currency": "usd", "created_at": "2026-07-22T10:00:00Z"}

{"id": "prod_4k8j2n", "name": "Wireless Headphones X1", "price": 7999, "category": "electronics", "description": "Premium ANC headphones", "variants": [{"sku": "WHX1-BLK", "name": "Black", "stock": 42}], "images": ["https://cdn.aetacorp.com/img/whx1.jpg"], "created_at": "2026-03-10T08:00:00Z"}

{"price": 6999, "in_stock": false}

{"id": "prod_4k8j2n", "price": 6999, "in_stock": false, "updated_at": "2026-07-22T10:30:00Z"}

Query: status user_id from to page

{"data": [{"id": "ord_2n5k8m", "user_id": "usr_8x7k2m", "status": "fulfilled", "total": 15998, "items": 2, "created_at": "2026-07-20T14:00:00Z"}], "pagination": {"page": 1, "total": 3241}}

{"user_id": "string", "items": [{"product_id": "string", "quantity": 1, "variant_sku": "string"}], "shipping": {"address_line1": "string", "city": "string", "zip": "string", "country": "string"}}

{"id": "ord_9p1m3x", "status": "pending", "total": 7999, "payment_url": "https://pay.aetacorp.com/checkout/ord_9p1m3x"}

{"id": "ord_2n5k8m", "user_id": "usr_8x7k2m", "status": "fulfilled", "total": 15998, "items": [{"product_id": "prod_4k8j2n", "name": "Wireless Headphones X1", "quantity": 1, "price": 7999}, {"product_id": "prod_7m3x9p", "name": "USB-C Hub Pro", "quantity": 2, "price": 4999}], "tracking": {"carrier": "FedEx", "number": "7489234561"}}

{"status": "shipped", "tracking_number": "string", "carrier": "string"}

{"id": "ord_2n5k8m", "status": "shipped", "updated_at": "2026-07-21T09:15:00Z"}

{"data": [{"id": "pay_3k9m2x", "order_id": "ord_2n5k8m", "amount": 15998, "currency": "usd", "status": "succeeded", "method": "visa_*4242", "created_at": "2026-07-20T14:01:00Z"}], "pagination": {"page": 1, "total": 2891}}

{"payment_id": "string", "amount": 0, "reason": "duplicate|fraud|requested_by_customer"}

{"id": "pay_ref_8m2x", "payment_id": "pay_3k9m2x", "amount": 7999, "status": "pending", "estimated_arrival": "2026-07-27"}

{"id": "pay_3k9m2x", "order_id": "ord_2n5k8m", "amount": 15998, "currency": "usd", "status": "succeeded", "method": {"type": "card", "brand": "visa", "last4": "4242", "exp_month": 12, "exp_year": 2028}, "receipt_url": "https://pay.aetacorp.com/receipt/pay_3k9m2x"}

Query: period (hourly|daily|weekly) from to

{"period": "daily", "data": [{"date": "2026-07-21", "requests": 14523, "errors": 23, "latency_avg_ms": 142, "cost_usd": 2.87}], "totals": {"requests": 14523, "errors": 23, "error_rate": 0.16, "cost_usd": 2.87}}

{"data": [{"endpoint": "POST /v1/products", "requests": 4521, "avg_latency_ms": 89, "p99_ms": 234, "error_rate": 0.02}, {"endpoint": "GET /v1/orders", "requests": 3201, "avg_latency_ms": 56, "p99_ms": 120, "error_rate": 0.01}]}

{"data": [{"code": 429, "count": 12, "message": "Rate limit exceeded", "last_seen": "2026-07-22T08:45:00Z"}, {"code": 500, "count": 3, "message": "Internal server error", "last_seen": "2026-07-21T22:10:00Z"}], "total_errors": 15}

{"data": [{"id": "wh_5n8k2m", "url": "https://yourapp.com/hooks/aetacorp", "events": ["order.created", "payment.succeeded", "user.created"], "active": true, "created_at": "2026-06-01T10:00:00Z"}]}

{"url": "string", "events": ["order.created", "payment.succeeded"], "secret": "string (optional — auto-generated if omitted)"}

{"id": "wh_7x3m9p", "url": "https://yourapp.com/hooks", "events": ["order.created"], "secret": "whsec_8k2m5n...", "active": true}

{"data": [{"id": "del_9x2m", "event": "order.created", "status": 200, "duration_ms": 142, "attempt": 1, "created_at": "2026-07-22T09:00:00Z"}, {"id": "del_8x3m", "event": "payment.succeeded", "status": 500, "duration_ms": 0, "attempt": 3, "created_at": "2026-07-22T08:55:00Z"}]}

Response 204: No content

{"query": "wireless headphones", "filters": {"category": "electronics", "in_stock": true}, "sort": "relevance|price_asc|price_desc", "page": 1}

{"results": [{"id": "prod_4k8j2n", "type": "product", "name": "Wireless Headphones X1", "score": 0.95, "price": 7999}], "total": 42, "took_ms": 23}

Query: q (prefix) limit

{"suggestions": ["wireless headphones", "wireless earbuds", "wireless keyboard", "wired headphones"], "took_ms": 8}

{"file": "(binary)", "purpose": "product_image|document|avatar"}

{"id": "file_8m2x9p", "url": "https://cdn.aetacorp.com/uploads/file_8m2x9p.jpg", "size_bytes": 245760, "content_type": "image/jpeg", "created_at": "2026-07-22T10:00:00Z"}

{"id": "file_8m2x9p", "filename": "hero-image.jpg", "size_bytes": 245760, "content_type": "image/jpeg", "url": "https://cdn.aetacorp.com/uploads/file_8m2x9p.jpg", "expires_at": "2026-08-22T10:00:00Z"}

{"to": "user_id or email", "channel": "email|sms|push", "subject": "string", "body": "string", "template": "string (optional)"}

{"id": "notif_5n8k2m", "channel": "email", "status": "queued", "estimated_delivery": "2026-07-22T10:05:00Z"}

{"data": [{"id": "notif_5n8k2m", "to": "jane@example.com", "channel": "email", "subject": "Order Confirmed", "status": "delivered", "opened": true, "created_at": "2026-07-22T09:00:00Z"}]}

{"data": [{"id": "inv_2m8x9p", "amount": 4900, "currency": "usd", "status": "paid", "period": "2026-07", "pdf_url": "https://billing.aetacorp.com/inv_2m8x9p.pdf"}]}

{"plan": "pro", "status": "active", "current_period_start": "2026-07-01", "current_period_end": "2026-08-01", "api_calls_used": 47823, "api_calls_limit": 100000, "overage_rate": 0.001}

{"plan": "pro", "limits": {"requests_per_minute": 1000, "requests_per_day": 100000, "concurrent": 50}, "current": {"requests_this_minute": 234, "requests_today": 47823, "concurrent": 3}}

{"data": [{"id": "log_8m2x", "action": "api_key.created", "actor": "usr_8x7k2m", "ip": "203.0.113.42", "created_at": "2026-07-22T09:00:00Z"}, {"id": "log_7x3m", "action": "webhook.deleted", "actor": "usr_8x7k2m", "details": {"webhook_id": "wh_5n8k2m"}, "created_at": "2026-07-22T08:55:00Z"}]}

{"status": "healthy", "version": "2.4.1", "uptime_seconds": 864000, "services": {"database": "ok", "cache": "ok", "queue": "ok", "storage": "ok"}, "region": "us-east-1"}