Address Confirmation

Using the Address Confirmation API

4min

Sign up for the Address Confirmation API

Connect with our Sales Team to sign up for the Address Confirmation API.

Making a Request

To confirm an address, make a POST request to the ConfirmAddress endpoint with the address details in the request body.

Before making a request to the Address Correlation API, ensure you have all the required parameters ready: address, has_consent, and consent_text.



Request Body

Parameter

Description

Type

Example

pincode

The pincode of the address.

string

“673593”

address*

The detailed address to be geocoded.

string

“Yogi complex g wing room no 103 1st floor”

city

The city of the address.

string

“Gurugram”

state

The state of the address.

string

“Kerala”

phone_number

The contact phone number.

string

“9999999999”

has_consent*

Signifies explicit customer approval for sharing their data with the API and using the resulting outputs. Consent must be informed and specific to these uses.

boolean

True

consent_text*

Contains the specific excerpt from the Terms & Conditions or Privacy Policy where the customer's consent is requested. This text should clearly detail the consent sought from the end customer.

string (Up to 2048 characters)





Example Request:

JSON


Understanding the Response

The Address Confirmation API will return a JSON response with the confirmation status.

Response Schema:

Parameter

Description

Example / Possible Values

data

Provides an array with details regarding the last visited date.

visited_before

Indicates whether the address has been visited by a field executive.

true/false

last_visited_date

Specifies the date of the last visit.

date in string or empty string

error

Contains details of any errors that occurred.

{"message": "Invalid query parameters provided in input","type": “value_error"}

status_code

The status code of the response.

200

request_id

A unique identifier for the request.

“liveness|aef66d7a-b09e-472f-b2b2-aa8e9ad3971e”

message

Provides information about the success or failure of the request.





JSON