Build on honest food.
The FreshOn Partner API.
A REST API for marketplaces, aggregators and ordering apps: read our full catalog — categories, products, pack variants, live availability — and place orders that flow straight into FreshOn's own picking and delivery operation.
https://api.freshon.in/api/partner/v1/Full catalog feed
Categories, subcategories and every product with its pack variants — selling price, MRP, GST rate, barcode, SKU, net weight and WebP product images, ready to mirror into your own listings.
Live availability
Every pack variant carries a real-time in_stock flag computed from our warehouse batches at request time, so your storefront never sells what we can't deliver.
Order placement
Place orders by SKU. Prices are always resolved on our side at order time, stock is committed instantly, and the order drops straight into FreshOn's own picking and delivery pipeline.
Configurable delivery
You decide where orders go: CUSTOMER mode ships each order to your buyer's address (dropship), COMPANY mode ships everything to your registered company address so you run the last mile.
Simple, secure auth
One API key per partner, sent as an X-API-Key header. Keys are stored hashed on our side, revocable instantly, and scoped to your own data only.
Usage you can see
Plan-based rate limits and daily/monthly quotas, with a /usage/ endpoint that shows your consumption and remaining headroom at any moment.
One switch decides where every order goes
As the integration developer, you configure the delivery target once — it's a setting on your key, not a per-order choice.
Dropship. Each order carries your buyer's address and contact — FreshOn delivers directly to your customer's doorstep, and you never touch the produce.
Bulk to you. Every order ships to your registered company address — you consolidate, repack and run the last mile yourself.
From application to first order in four steps
- 01 — Apply
Send one request to the public /register/ endpoint with your company details, use case and the plan you'd like. No key needed.
- 02 — Review & key
The FreshOn team reviews your application. On approval we issue your API key on the requested plan and hand it over securely — it's shown exactly once, so store it in a secrets manager.
- 03 — Configure delivery
Call PUT /config/ to choose CUSTOMER or COMPANY delivery mode (and register your company address for the latter). Verify everything with GET /ping/.
- 04 — Sync & sell
Pull the catalog nightly, poll availability intraday, and start placing orders. Track your consumption anytime via GET /usage/.
curl -X POST https://api.freshon.in/api/partner/v1/register/ \
-H "Content-Type: application/json" \
-d '{
"company_name": "Acme Marketplace",
"contact_name": "Ravi Kumar",
"email": "api@acme.example",
"use_case": "List FreshOn produce on our marketplace",
"requested_plan": "STANDARD"
}'curl -X POST https://api.freshon.in/api/partner/v1/orders/ \
-H "X-API-Key: fsk_your_key_here" \
-H "Content-Type: application/json" \
-d '{
"items": [{ "sku": "ORAN-1KG-a1b2c3d4", "quantity": 2 }],
"customer": { "name": "Ravi Kumar", "phone": "+919876543210" },
"delivery_address": { "address_line": "5 Lake View Rd, Bengaluru 560034" },
"external_reference": "ACME-1001"
}'Fair limits that grow with you
| Plan | Burst rate | Daily quota | Monthly quota |
|---|---|---|---|
| Free | 60 / min | 5,000 / day | 100,000 / month |
| Standard | 120 / min | 20,000 / day | 400,000 / month |
| Enterprise | 300 / min | 100,000 / day | 2,000,000 / month |
Every ceiling is visible on your key via /ping/ and can be raised individually for high-volume partners — just ask.
| Method | Endpoint | What it does |
|---|---|---|
| POST | /register/ | Apply for access (no key needed) |
| GET | /ping/ | Validate your key & see its limits |
| GET | /categories/ | Categories with nested subcategories |
| GET | /subcategories/ | Subcategories, filterable by category |
| GET | /products/ | Products + variants; filter by category, search, SKU, barcode, in-stock |
| GET | /products/{id}/ | Full product detail with image gallery |
| GET/PUT | /config/ | Your delivery mode & company address |
| POST | /orders/ | Place an order by SKU |
| GET | /orders/ | Your orders — filter by status or your own reference |
| GET | /usage/ | Consumption vs your plan's quotas |
Need the full request/response reference, sync recipes or a higher plan? Write to support@freshon.in with the subject “Partner API” and we'll get you the complete integration guide.