Krishiji API Overview Docs Register Sign in

API Reference

Base URL: https://krishiji.com/api/v1/public

Authentication

All requests must include an API key in the Authorization header:

Authorization: Bearer kj_live_XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX

Generate a key from your dashboard after your partner application is approved.

Errors & rate limits

401 missing or invalid API key
403 partner not approved or suspended
404 resource not found
429 rate limit exceeded (Free: 60/min, Pro: 600/min). Includes Retry-After header.

Response envelope

{
  "data": [...],
  "meta": { "page": 1, "per_page": 25, "total": 412, "last_page": 17 },
  "links": {
    "self": "...?page=1",
    "next": "...?page=2",
    "prev": null
  }
}

Products

GET /api/v1/public/products

List marketplace products. Filters: category, state, organic.

curl -H 'Authorization: Bearer kj_live_XXXX' \
  'https://example.com/api/v1/public/products?category=Grains&state=Punjab&page=1'

GET /api/v1/public/products/{id}

Get one product by id.

curl -H 'Authorization: Bearer kj_live_XXXX' \
  https://example.com/api/v1/public/products/123

Sellers

GET /api/v1/public/sellers

List active sellers (tenants). Filters: state, business_type.

curl -H 'Authorization: Bearer kj_live_XXXX' \
  https://example.com/api/v1/public/sellers

GET /api/v1/public/sellers/{id}

Get one seller by id.

curl -H 'Authorization: Bearer kj_live_XXXX' \
  https://example.com/api/v1/public/sellers/42

Mandi

GET /api/v1/public/mandi-prices

Daily mandi prices. Filters: commodity, state, mandi, date (YYYY-MM-DD).

curl -H 'Authorization: Bearer kj_live_XXXX' \
  'https://example.com/api/v1/public/mandi-prices?commodity=Wheat&state=Madhya%20Pradesh'

Commodities

GET /api/v1/public/commodities

Master list of supported commodities.

curl -H 'Authorization: Bearer kj_live_XXXX' \
  https://example.com/api/v1/public/commodities

Schemes

GET /api/v1/public/schemes

Government schemes. Filters: level, featured.

curl -H 'Authorization: Bearer kj_live_XXXX' \
  https://example.com/api/v1/public/schemes?featured=true

GET /api/v1/public/schemes/{slug}

Get a scheme by slug.

curl -H 'Authorization: Bearer kj_live_XXXX' \
  https://example.com/api/v1/public/schemes/pm-kisan

Weather

GET /api/v1/public/weather/{state}/{city}

Current weather + 5-day forecast.

curl -H 'Authorization: Bearer kj_live_XXXX' \
  https://example.com/api/v1/public/weather/Punjab/Ludhiana

Metadata

GET /api/v1/public/meta/states

List of state names known to the platform.

curl -H 'Authorization: Bearer kj_live_XXXX' \
  https://example.com/api/v1/public/meta/states

GET /api/v1/public/meta/categories

List of product categories.

curl -H 'Authorization: Bearer kj_live_XXXX' \
  https://example.com/api/v1/public/meta/categories