Farm Yield Report (Multiland) — Satsure

What does this API do?

The Farm Yield Report API (provided by SatSure Analytics India Pvt Ltd, service code 104) delivers farm health parameters — including irrigation conditions, water body proximity, groundwater availability, minimum support prices, crop yield potential, and weather history — derived from geospatial and satellite data.

Two services are available:

• farmyieldreport (v1.4) — Single land parcel query, synchronous GET request. Returns SatScore, cropping history, regional parameters, farm geometry, and neighbouring parcel data.
• farmyieldreportmultiland (v1.5) — Up to 5 land parcels per request, asynchronous POST request. A report-requested acknowledgement is returned immediately; the full report is delivered to the lender's registered callback URL once SatSure processes it (typically within 5 seconds).

State coverage for the multiland service: Madhya Pradesh (23), Odisha (21), Telangana (36), Maharashtra (27), Andhra Pradesh (37).

Who can use it?

Lenders and financial institutions onboarded to the ULI Platform who have subscribed to the Farm Yield Report service in the Developer Portal.

What are the prerequisites?

Complete all common platform prerequisites as described in Getting Started with ULI Platform APIs.

In addition, the following are specific to this service:

• SatSure member ID: An x-sp-memberId is assigned to each lender by SatSure during registration and must be passed as a header on every request.
• For the multiland (async) service, the lender must register a callback URL with the platform during UAT onboarding. An x-lender-auth-token (JWT) should also be provided so that the platform can authenticate callbacks posted to the lender.
• Ensure the Farm Yield Report service is subscribed separately for Sandbox and Production in the Dev Portal.

What are the API endpoints?

farmyieldreport (single parcel, synchronous GET)

farmyieldreportmultiland (multi-parcel, asynchronous POST)

What headers must be sent?

farmyieldreport headers

farmyieldreportmultiland headers (additional)

What does the request body look like?

farmyieldreport is a GET API — all parameters are passed as headers (see above).

farmyieldreportmultiland uses the following JSON body structure:

{
  "meta": {
    "ver": "1.5",
    "ts": "2023-01-03T21:10:23+05:30",
    "txncode": "unique-transaction-code"
  },
  "data": {
    "landRecordData": [
      {
        "state": "23",
        "village_lgd_code": "340902",
        "khasara": "6 (S)"
      }
    ]
  },
  "hmac": "SHA-256 hash of the value of key 'data'"
}

Note: Only fields relevant to each state need to be included. Refer to state-specific sample payloads in the API specification.

What does the response contain?

farmyieldreport (synchronous) response fields

farmyieldreportmultiland (async) initial response

Returns "response": "Satsource Report Requested Successfully" with errcode: E000. The full report is sent to the lender's callback URL as a PDF in base64 format, along with a referenceId, txncode, and a boolean status field.

What are the error codes?

Refer to the Latest Platform Error Code document on the Dev Portal for the full list of error values applicable to this service.

Who do I contact for support?

Write to support@rbihub.in with the following details:

• Subject: Farm Yield API Error
• Service Name: Farm Yield Report
• Environment: Sandbox / Production
• Service Provider code: 104 (SatSure)
• Request Payload (headers and body)
• Error Code and Error Message received
• Screenshot or log of the error
• Prerequisites status: IP Whitelisting, URL Whitelisting, Service Subscription, Token Generation