TrueAcre
Sign UpLogin
Home/Developers
{ } DEVELOPER PLATFORM

The TrueAcre API. Land data, programmatically.

Listings, valuations, KYC, transactions, even sub-registrar slot availability — all behind a clean REST API. Use it to build farmland tools, banking integrations, news products, or whatever else.

Get an API key →Read docs
terminal — bash
# Fetch verified listings in Chikmagalur
curl https://api.trueacre.in/v1/listings \
  -H "Authorization: Bearer ta_live_xxxx" \
  -d "belt=chikmagalur" \
  -d "verified=true" \
  -d "min_acres=10"

# Response · 142 results · 84ms
{
  "data": [
    {
      "id": "prop_blr_2891",
      "type": "plantation",
      "acres": 14.2,
      "price_inr": 28000000,
      "verified": true,
      "trust_score": 94
    }
    // ... 141 more
  ],
  "has_more": true,
  "next_cursor": "cur_x82f"
}

Endpoints by category.

31 endpoints organised across 6 resources. Versioned at /v1/*. Backwards compatible for at least 12 months after deprecation.

Listings & properties · 8 endpoints
get
/v1/listings

Paginated list of active listings with full filters: belt, acres, price, verification status, water source.

public · read
get
/v1/listings/:id

Full listing detail including all documents, photos, soil report, GPS boundary.

scoped · read
post
/v1/listings

Create a listing as a verified partner agent. Requires agent scope.

agent · write
put
/v1/listings/:id

Update price, description, or status. Re-triggers verification if material changes.

agent · write
get
/v1/listings/:id/comps

Find comparable closed transactions for a listing. Powers our valuation tool.

premium · read
get
/v1/listings/:id/timeline

Full audit timeline for a listing — moderation, verification, price changes.

scoped · read
Valuation & market data · 6 endpoints
post
/v1/valuation

Estimate value of any parcel by survey number + features. Powers our valuation tool.

premium
get
/v1/market/belts

Median price, transaction count, and trend by belt. Updated daily.

public
get
/v1/market/circle-rates

State-government circle/guidance rates. Refreshed when state publishes new circulars.

public
get
/v1/market/transactions

Anonymous closed-transaction data. Aggregated, no PII. For research & analyst use.

academic
KYC, users & offers · 9 endpoints
post
/v1/kyc/aadhaar/otp

Initiate Aadhaar OTP-based eKYC. UIDAI-compliant. AUA partner credentials required.

restricted
post
/v1/kyc/verify

Complete KYC with OTP, selfie+liveness, PAN. Returns KYC tier.

restricted
post
/v1/offers

Make an offer on a listing on behalf of a verified user.

user-scoped
get
/v1/offers/:id

Status of an offer (pending, accepted, countered, rejected) + counter-history.

user-scoped
Webhooks · 8 events
evt
listing.created

A new listing was created. Fires before public visibility.

webhook
evt
listing.verified

A listing has completed verification (or failed).

webhook
evt
offer.accepted

An offer was accepted by the seller. Use this to trigger your loan pre-approval flow.

webhook
evt
escrow.deposited

Earnest deposit landed. Use to update your downstream systems.

webhook
evt
transaction.complete

Sub-registrar registration done. Receipt + deed PDF in payload.

webhook
evt
user.kyc_completed

A user finished KYC. Tier in payload. Useful for KYC-once-use-anywhere flows.

webhook

SDKs we maintain.

Official SDKs for the four ecosystems we see most. Community SDKs available for Java, .NET and Elixir.

PY

Python

trueacre · 2.4.0
$ pip install trueacre
JS

Node.js / TypeScript

@trueacre/sdk · 2.4.1
$ npm i @trueacre/sdk
GO

Go

github.com/trueacre/sdk-go
$ go get trueacre/sdk-go
RB

Ruby

trueacre · 2.4.0
$ gem install trueacre

Plans & pricing.

Free tier covers most read-only use. Webhooks and KYC need a paid plan because of the costs we pass through. No hidden charges.

Sandbox
Free

For prototyping & learning. Test data only — no live listings.

  • ✓1,000 req / day
  • ✓Sandbox dataset
  • ✓All read endpoints
  • ✓Community support
Developer
₹4,999 / month

For startups + indie devs building on live data.

  • ✓50K req / day
  • ✓Live listings + market data
  • ✓5 webhook subscriptions
  • ✓Email support · 24h SLA
Business
₹24,999 / month

For loan partners, fintech apps, agencies at scale.

  • ✓500K req / day
  • ✓KYC + transactions endpoints
  • ✓Unlimited webhooks
  • ✓Phone support · 4h SLA
Enterprise
Custom

For banks & institutions needing volume + custom SLAs.

  • ✓Unlimited requests
  • ✓Dedicated infrastructure
  • ✓On-prem option
  • ✓Custom contract + DPA
Free for academia & non-profit research.

If you're studying Indian agriculture, land markets or rural economics — we'll waive the Business-tier limits. Email research@trueacre.in with your institutional ID.