REST API

API reference

Base URL https://api.obaol.com. Protected requests use Authorization: Bearer <API_KEY>.

MethodEndpointPermissionPurpose
GET/v1/catalog/summaryproducts:read + labs:readLive catalog and MCP counts
GET/v1/products/liveproducts:readSearch live product listings
GET/v1/products/allproducts:readRead the complete product catalog
GET/v1/labs/livelabs:readSearch public-safe quality labs
GET/v1/pricesprices:readRead commodity prices
GET/v1/traderstraders:readRead trader records
POST/v1/inquiriesinquiries:createCreate an external enquiry
POST/v1/calculate/cifcalculator:useCalculate CFR/CIF values

Live products

curl "https://api.obaol.com/v1/products/live?search=turmeric&page=1&limit=20" \
  -H "Authorization: Bearer <API_KEY>"

Published labs

curl "https://api.obaol.com/v1/labs/live?commodity=turmeric&state=Karnataka" \
  -H "Authorization: Bearer <API_KEY>"

Response envelope

Successful list routes return success, data, and pagination meta with page, limit, total, and pages.

Errors

400 invalid input · 401 missing/invalid key · 403 missing permission · 429 rate limited · 500 service error.

Safe lab fields

Lab APIs exclude email, phone, WhatsApp, private notes, and internal workflow fields.