Complete reference documentation for all Organiko.ai API endpoints
Manage user authentication and tokens.
/auth/loginAuthenticate with email and password
/auth/refreshRefresh access token using refresh token
/auth/logoutInvalidate current tokens
/auth/verifyVerify token validity
/auth/forgot-passwordRequest password reset email
/auth/reset-passwordReset password with token
Manage subscriptions, usage, and billing.
/subscriptions/currentGet current subscription details
/subscriptions/usageGet usage metrics and limits
/subscriptions/upgradeUpgrade or downgrade subscription tier
/subscriptions/cancelCancel subscription (effective at period end)
/subscriptions/invoicesList all invoices
/subscriptions/invoices/:idGet specific invoice details
/subscriptions/payment-methodsList saved payment methods
Manage products, batches, and inventory levels.
/inventoryList all inventory items with filters
/inventory/productsCreate new product
/inventory/products/:idGet product details
/inventory/products/:idUpdate product information
/inventory/batchesList all batches
/inventory/batchesCreate new batch
/inventory/batches/:idGet batch details
Manage purchase orders, sales orders, and reconciliation.
/orders/purchaseList purchase orders
/orders/purchaseCreate purchase order
/orders/purchase/:idGet purchase order details
/orders/salesList sales orders
/orders/salesCreate sales order
/orders/sales/:idGet sales order details
/orders/reconcileReconcile purchase order with inventory
Generate compliance reports and analytics.
/reports/mass-balanceGenerate mass balance report
/reports/tracebackGenerate traceback report
/reports/complianceGenerate USDA compliance report
/reports/audit-logGet audit log entries
Manage user accounts and permissions.
/users/meGet current user profile
/users/meUpdate current user profile
/usersList all users in organization
/usersCreate new user
/users/:idDelete user
Manage third-party integrations.
/integrationsList all connected integrations
/integrations/:provider/connectInitiate OAuth connection to provider
/integrations/:idDisconnect integration
/integrations/:id/syncTrigger manual sync
Manage webhook subscriptions.
/webhooksList all webhook endpoints
/webhooksCreate webhook endpoint
/webhooks/:idDelete webhook endpoint
/webhooks/:id/deliveriesView webhook delivery history
Many list endpoints support these common parameters:
| Parameter | Type | Description |
|---|---|---|
| limit | number | Number of results (default: 20, max: 100) |
| offset | number | Skip number of results for pagination |
| sort | string | Field to sort by (prefix with - for descending) |
| filter | string | Filter expression (e.g., status:active) |
| Code | Description |
|---|---|
| 200 | Success |
| 201 | Created |
| 400 | Bad Request - Invalid parameters |
| 401 | Unauthorized - Invalid or missing authentication |
| 403 | Forbidden - Insufficient permissions |
| 404 | Not Found - Resource doesn't exist |
| 429 | Too Many Requests - Rate limit exceeded |
| 500 | Server Error - Something went wrong |