RERA V2

Endpoint Overview

POST /api/v1/rera/rera-v2

Description

The RERA V2 API allows you to retrieve detailed information about real estate projects and agents registered under the Real Estate Regulatory Authority (RERA) in various Indian states. This API provides comprehensive verification of RERA registration details, including certificate information, project specifics, and agent credentials.

Key Benefits

Instant verification of RERA registration numbers across multiple states

Access to official RERA certificate URLs and detailed project/agent information

Simplified due diligence for real estate transactions and investments

Compliance with regulatory requirements for real estate businesses

Use Cases

Real Estate

Financial Services

Legal Services

Verify legitimacy of projects before listing on property portals

Conduct due diligence on developers before partnership agreements

Automate verification of project details for property listings

Technical Implementation

Authentication

All API requests require authentication using a JWT Bearer token. Authentication follows these steps:

Obtain API Credentials: Register with Surepass to receive your API key.

Generate JWT Token: Use your API key to generate a JWT token.

Include in Requests: Add the token to the Authorization header as Bearer TOKEN.

Different authentication tokens are used for sandbox and production environments:

Sandbox: https://sandbox.surepass.io

Production: https://kyc-api.surepass.io

Request Parameters

Request Headers

Header	Required	Description
Authorization	Yes	Bearer token for authentication (JWT)
Content-Type	Yes	application/json

Request Body

Parameter	Type	Required	Description
registration_number	String	Yes	RERA registration number to verify
registration_type	String Enum	Yes	Type of registration (`project` or `agent`)
state_name	String Enum	Yes	State where the project/agent is registered

Supported Registration Types

project - For real estate projects

agent - For real estate agents/brokers

Supported States

uttar_pradesh

kerala

assam

west_bengal

madhya_pradesh

bihar

chhattisgarh

delhi

karnataka

uttarakhand

maharashtra

haryana

telangana

Example Request

{
    "registration_number": "UPREPRJ0000",
    "registration_type": "project",
    "state_name": "uttar_pradesh"
}

Process Response

Response Parameters

Parameter	Type	Description
data	Object	Contains the verification results
data.client_id	String	Unique identifier for this verification request
data.registration_number	String	RERA registration number that was verified
data.registration_type	String	Type of registration that was verified
data.state_name	String	State name for which verification was performed
data.details	Array	Array containing detailed information about the project/agent
status_code	Integer	HTTP status code of the response
success	Boolean	Indicates if the request was successful
message	String	Response message
message_code	String	Code representing the response message

Details Object Properties

Property	Type	Description
agent_name	String	Name of the RERA registered agent
promoter_name	String	Name of the project promoter
certificate_number	String	RERA certificate number
project_name	String	Name of the RERA registered project
certificate_url	String	URL to download the RERA certificate PDF
project_address	String	Address of the project
project_id	String	RERA project identifier
project_district	String	District where the project is located
registered_with	String	Authority with which the project is registered
approved_date	String	Date of project approval (YYYY-MM-DD)
expiry_date	String	Expiration date of registration (YYYY-MM-DD)
district	String	District name
category	String	Project category
certificate_issuing_date	String	Date when certificate was issued (YYYY-MM-DD)
completion_date	String	Expected project completion date (YYYY-MM-DD)
registration_date	String	Date of RERA registration (YYYY-MM-DD)
agent_id	String	RERA agent identifier
proprietor_name	String	Name of the project proprietor
contact_number	String	Contact number for the agent/project
agent_email	String	Email address of the agent
address	String	Address of the agent/project
status	String	Current status of the project
application_number	String	Application number for the agent/project
last_modified	String	Last modification date (YYYY-MM-DD)
authorised_name	String	Name of the authorized person
tehsil	String	Tehsil of the agent/project
extended_expiry_date	String	Extended expiry date if applicable (YYYY-MM-DD)
application_date	String	Date of application (YYYY-MM-DD)
promoter_email	String	Email address of the promoter
promoter_number	String	Contact number of the promoter

Example Successful Response

{
    "data": {
        "client_id": "rera_v2_uAMxmuawqHaWqVwOKNfe",
        "registration_number": "UPPRJ000",
        "registration_type": "project",
        "state_name": "uttar_pradesh",
        "details": [
            {
                "agent_name": null,
                "promoter_name": null,
                "certificate_number": null,
                "project_name": "MIRZAPUR  PHASE I",
                "certificate_url": "https://aadhaar-kyc-docs.s3.amazonaws.com/up_rera/UPRE0000/project/rera_v2_uAMxmuawqHaWqVwOKNfe/certificate-2023-09-13-061352798274.pdf?",
                "project_address": "Tehshil- Nagar",
                "project_id": null,
                "project_district": null,
                "registered_with": null,
                "approved_date": null,
                "expiry_date": null,
                "district": null,
                "category": null,
                "certificate_issuing_date": null,
                "completion_date": null,
                "registration_date": null,
                "agent_id": null,
                "proprietor_name": null,
                "contact_number": null,
                "agent_email": null,
                "address": null,
                "status": null,
                "application_number": null,
                "last_modified": null,
                "authorised_name": null,
                "tehsil": null,
                "extended_expiry_date": null,
                "application_date": null,
                "promoter_email": null,
                "promoter_number": null
            }
        ]
    },
    "status_code": 200,
    "success": true,
    "message": "Success",
    "message_code": "success"
}

Possible Error Responses

Invalid Registration Number

Invalid State

Authentication Error

{
    "status_code": 400,
    "success": false,
    "message": "Invalid RERA registration number",
    "message_code": "invalid_registration_number"
}

The provided RERA registration number is invalid or not found in the specified state.

Integration Best Practices

Security Recommendations

Store JWT tokens securely and never expose them in client-side code

Implement proper error handling to manage API failures gracefully

Validate input parameters before sending requests to prevent injection attacks

Implement rate limiting on your side to prevent API abuse

User Experience Guidelines

Provide clear feedback to users when RERA verification is in progress

Display comprehensive RERA details in an organized, easy-to-understand format

Include direct links to certificate URLs when displaying verification results

Implement caching for frequently accessed RERA details to improve performance

Code Samples

cURL

Python

Node.js

Related APIs

RERA V1 API - Previous version of the RERA verification API with limited state support

Property Ownership Verification API - Verify property ownership details

Address Verification API - Verify addresses against official records

Compliance and Legal Considerations

The information provided through this API is sourced from official RERA portals of respective states. While using this API, ensure compliance with data privacy regulations and obtain necessary consent when storing or processing personal information. The RERA data should be used in accordance with the guidelines set by respective state RERA authorities.

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

curl --location --request POST 'https://kyc-api.surepass.app/api/v1/rera/rera-v2' \ --header 'Authorization: Bearer <token>' \ --header 'Content-Type: application/json' \ --data-raw '{ "registration_number": "UPREPRJ0000", "registration_type": "project", "state_name": "uttar_pradesh" }'

{ "data": { "client_id": "rera_v2_uAMxmuawqHaWqVwOKNfe", "registration_number": "UPPRJ000", "registration_type": "project", "state_name": "uttar_pradesh", "details": [ { "agent_name": null, "promoter_name": null, "certificate_number": null, "project_name": "MIRZAPUR PHASE I", "certificate_url": "https://aadhaar-kyc-docs.s3.amazonaws.com/up_rera/UPRE0000/project/rera_v2_uAMxmuawqHaWqVwOKNfe/certificate-2023-09-13-061352798274.pdf?", "project_address": "Tehshil- Nagar", "project_id": null, "project_district": null, "registered_with": null, "approved_date": null, "expiry_date": null, "district": null, "category": null, "certificate_issuing_date": null, "completion_date": null, "registration_date": null, "agent_id": null, "proprietor_name": null, "contact_number": null, "agent_email": null, "address": null, "status": null, "application_number": null, "last_modified": null, "authorised_name": null, "tehsil": null, "extended_expiry_date": null, "application_date": null, "promoter_email": null, "promoter_number": null } ] }, "status_code": 200, "success": true, "message": "Success", "message_code": "success" }

RERA V2

RERA V2#

Description#

Use Cases#

Technical Implementation#

Request Headers#

Request Body#

Supported Registration Types#

Supported States#

Example Request#

Response Parameters#

Details Object Properties#

Example Successful Response#

Possible Error Responses#

Integration Best Practices#

Code Samples#

Request

Responses

RERA V2

Description

Use Cases

Technical Implementation

Request Headers

Request Body

Supported Registration Types

Supported States

Example Request

Response Parameters

Details Object Properties

Example Successful Response

Possible Error Responses

Integration Best Practices

Code Samples