Organiko.ai API

RESTful API for programmatic access to organic compliance and inventory management

API Overview

The Organiko.ai API provides programmatic access to your organic compliance data, inventory management, and reconciliation workflows. Build custom integrations, automate tasks, and sync data with your existing systems.

🔐
Secure
OAuth 2.0 & JWT authentication
Fast
Low latency, high performance
📚
RESTful
Predictable, resource-oriented URLs

Base URL

All API requests should be made to:

https://api.organiko.ai/v1

Note: We maintain API versioning to ensure backward compatibility. The current version is v1.

Authentication

All API requests require authentication using a Bearer token in the Authorization header:

Authorization: Bearer YOUR_ACCESS_TOKEN

You can obtain an access token by authenticating with your API credentials.

View Authentication Guide →

Rate Limits

API rate limits vary by subscription tier to ensure fair usage and system stability:

PlanRequests/HourRequests/DayBurst Limit
Free1001,00010/min
Starter1,00010,00030/min
Professional5,000100,000100/min
Business10,000200,000200/min
EnterpriseUnlimitedUnlimitedCustom

Rate limit headers are included in all API responses: X-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-Reset

Response Format

All API responses are returned in JSON format with consistent structure:

{ "success": true, "data": { // Response data }, "meta": { "timestamp": "2025-10-30T12:00:00Z", "requestId": "req_abc123" } }

Error responses include additional details:

{ "success": false, "error": { "code": "invalid_request", "message": "Missing required parameter: email", "details": { "field": "email", "reason": "required" } }, "meta": { "timestamp": "2025-10-30T12:00:00Z", "requestId": "req_xyz789" } }

Available Endpoints

Authentication API

Login, logout, token refresh, password management

POST /auth/loginPOST /auth/refreshPOST /auth/logout

Subscription API

Manage subscriptions, usage, billing, and invoices

GET /subscriptionsGET /usageGET /invoices

Inventory API

Manage products, batches, and inventory levels

GET /inventoryPOST /inventory/productsGET /inventory/batches

Orders API

Purchase orders, sales orders, and reconciliation

GET /orders/purchaseGET /orders/salesPOST /orders/reconcile

Reports API

Mass balance, traceback, and compliance reports

GET /reports/mass-balanceGET /reports/tracebackGET /reports/compliance

SDKs & Libraries

Official SDKs are available for popular programming languages:

🟦
TypeScript / JavaScript
npm install @organiko/api-client
🐍
Python
pip install organiko-api
♦️
Ruby
gem install organiko
Java
Maven / Gradle available
View Code Examples →

Need Help?

Our developer support team is here to help you integrate with our API.