Property Search Report — TEAL India

What does this API do?

The Property Search Report API (provided by TEAL India, service code 114) enables lenders to digitally initiate and retrieve property due diligence reports. Three report types are supported in a single request:

• Digital Property Search Report (DPSR) — a title search on the property
• CERSAI Search Report — checks security interests registered on the property
• Legal Due Diligence Report (LDDR) — a comprehensive legal opinion requiring document uploads by the lender

The service is asynchronous: reports are delivered to the lender's registered callback URL once ready. Six API endpoints cover the full lifecycle: report initiation, document upload, document status update, comment exchange, report status polling, and report download.

Who can use it?

Lenders and financial institutions onboarded to the ULI Platform who have subscribed to the TEAL Property Search 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:

• The lender's callback URL must be registered with the ULI Platform during onboarding. DPSR, CERSAI, and LDDR reports are pushed to this URL when ready.
• An x-sp-auth-token (JWT) must be provided so the platform can authenticate callbacks sent to the lender.
• TEAL will provide a query-id in the initiation response; this is required for subsequent document upload, status, and comment calls.
• For SBI-specific integrations, x-sp-lender-code and x-sp-access-token headers are additionally required.
• Ensure the TEAL service is subscribed separately for Sandbox and Production in the Dev Portal.

What are the API endpoints?

What headers must be sent?

The following headers apply to all endpoints. Additional headers are noted where applicable.

What does the request body look like?

propsearchteal — Initiation request

{
  "data": {
    "applicant-details": { "name": "Applicant Name", "pan": "PANXXXXXX" },
    "mortgager-details": { "name": "Mortgager Name" },
    "property-details": {
      "address": "Full property address",
      "pincode": "560001",
      "district": "Bengaluru Urban",
      "state": "Karnataka",
      "type": "Apartment"
    },
    "reference-data": { "case-number": "LAN/KA/2246", "lender-code": "BANK_QP286" },
    "reports-requested": ["Digital Property Search Report", "CERSAI Search Report", "Legal Due Diligence Report"]
  },
  "meta": { "ts": "2023-01-03T21:10:23+05:30", "ver": "1.3", "txncode": "KA01" },
  "hmac": "SHA-256 hash of key 'data'"
}

propsearchtealdocupload — Document upload

Pass data.id (document ID from the TEAL callback), data.name (document name), data.file-type (e.g., application/pdf), and data.base64 (base64-encoded file content, max 200 MB).

propsearchtealdocstatus — Document status

Pass data.id (document ID), data.status (Not Available or Waived), and an optional data.remark.

propsearchtealcomment — Comment

Pass data.comment with your clarification text.

What does the response contain?

On successful initiation, the response includes a query_id that must be stored for subsequent document and status calls. Reports are delivered asynchronously to the lender's callback URL. The callback payload includes:

The platform retries failed callback deliveries up to three times.

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: Property Search API Error (Teal)
• Service Name: Property Search (Teal)
• Environment: Sandbox / Production
• Service Provider code: 114 (TEAL)
• 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