API Reference
Complete reference documentation for all API endpoints.
Base URL
Production
https://api.regentherapy.com/api/v1Sandbox
https://sandbox.regentherapy.com/api/v1Resources
Orders
Create, retrieve, and manage orders
| Method | Endpoint | Description |
|---|---|---|
| GET | /orders | List all orders |
| POST | /orders | Create an order |
| GET | /orders/{id} | Get order details |
| PUT | /orders/{id} | Update an order |
Products
Access and manage product catalog
| Method | Endpoint | Description |
|---|---|---|
| GET | /products | List all products |
| POST | /products | Create a product |
| GET | /products/{id} | Get product details |
| PUT | /products/{id} | Update a product |
Inventory
Track and adjust inventory levels
| Method | Endpoint | Description |
|---|---|---|
| GET | /inventory | List inventory levels |
| PUT | /inventory | Adjust inventory |
Commissions
View commissions and schedule payouts
| Method | Endpoint | Description |
|---|---|---|
| GET | /commissions | List commissions |
| POST | /commissions | Schedule payout |
Webhooks
Configure webhook endpoints
| Method | Endpoint | Description |
|---|---|---|
| GET | /webhooks | List webhook endpoints |
| POST | /webhooks | Create endpoint |
| DELETE | /webhooks/{id} | Delete endpoint |
API Keys
Manage API keys and permissions
| Method | Endpoint | Description |
|---|---|---|
| GET | /api-keys | List API keys |
| POST | /api-keys | Create API key |
| DELETE | /api-keys/{id} | Revoke API key |
Response Format
All API responses follow a consistent JSON structure
Success Response
{
"success": true,
"data": { ... },
"meta": {
"timestamp": "2026-04-18T14:30:00Z",
"requestId": "req_abc123"
}
}Error Response
{
"success": false,
"error": {
"code": "VALIDATION_ERROR",
"message": "Invalid input",
"details": { ... }
},
"meta": { ... }
}Error Codes
Standard error codes returned by the API
| Code | HTTP Status | Description |
|---|---|---|
| UNAUTHORIZED | 401 | Missing or invalid authentication |
| FORBIDDEN | 403 | Insufficient permissions for this action |
| NOT_FOUND | 404 | Requested resource does not exist |
| VALIDATION_ERROR | 400 | Invalid input data |
| CONFLICT | 409 | Resource conflict (e.g., duplicate) |
| RATE_LIMITED | 429 | Too many requests |
| INTERNAL_ERROR | 500 | Server error |
Pagination
List endpoints support cursor-based pagination
| Parameter | Type | Default | Description |
|---|---|---|---|
| page | integer | 1 | Page number (1-indexed) |
| limit | integer | 20 | Items per page (max: 100) |
Pagination Response
{
"data": [...],
"pagination": {
"page": 1,
"limit": 20,
"total": 156,
"pages": 8
}
}