Physical Address Verification

Contact & Address

A field agent visits the address and confirms residence with geotagged evidence.

When a digital check is not enough, emver's field network visits the address, confirms the person lives or works there, captures geotagged photos and neighbour confirmation, and delivers the result through the API.

Endpoint

POST https://app.emver.io/api/sandbox/v1/physical-address-verification

Authorization: Bearer YOUR_API_KEY

Content-Type: application/json

Accept: application/json

Request parameters

Field	Type	Description
`name` required	string	Name of the person
`address` required	string	Full address
`pincode` required	string	PIN code
`mobile` required	phone	Contact mobile
`address_type` optional	string	Address type (current / permanent / office)

Example request

cURL

curl -X POST https://app.emver.io/api/sandbox/v1/physical-address-verification \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -d '{
    "name": "string",
    "address": "string",
    "pincode": "string",
    "mobile": "9999999999",
    "address_type": "string"
}'

import requests

response = requests.post(
    "https://app.emver.io/api/sandbox/v1/physical-address-verification",
    headers={
        "Authorization": "Bearer YOUR_API_KEY",
        "Accept": "application/json",
    },
    json={
        "name": "string",
        "address": "string",
        "pincode": "string",
        "mobile": "9999999999",
        "address_type": "string"
    },
    timeout=60,
)
response.raise_for_status()
data = response.json()

const response = await fetch("https://app.emver.io/api/sandbox/v1/physical-address-verification", {
  method: "POST",
  headers: {
    "Authorization": "Bearer YOUR_API_KEY",
    "Content-Type": "application/json",
    "Accept": "application/json",
  },
  body: JSON.stringify({
      "name": "string",
      "address": "string",
      "pincode": "string",
      "mobile": "9999999999",
      "address_type": "string"
  }),
});

const data = await response.json();

$response = Http::withToken('YOUR_API_KEY')
    ->acceptJson()
    ->post('https://app.emver.io/api/sandbox/v1/physical-address-verification', {
        "name": "string",
        "address": "string",
        "pincode": "string",
        "mobile": "9999999999",
        "address_type": "string"
    });

$data = $response->json();

Replace YOUR_API_KEY and the placeholder values. Use the switch above to see production URLs.

Response

Structure · 200

{
  "status": INTEGER,
  "message": STRING,
  "data": {
    "request_id": STRING,
    "status": STRING,
    "outcome": STRING,
    "visited_at": DATE,
    "gps": STRING,
    "photos": ARRAY,
    "report_url": STRING
  }
}

Example · 200

{
  "status": 200,
  "message": "string",
  "data": {
    "request_id": "string",
    "status": "string",
    "outcome": "string",
    "visited_at": "YYYY-MM-DD",
    "gps": "string",
    "photos": "string",
    "report_url": "string"
  }
}

Error · 4xx / 5xx

{
  "status": INTEGER,
  "message": STRING
}

See Errors & status codes for what each status means and which calls are billed.

About this API

An asynchronous check. Submit the address and contact details; the visit is scheduled, completed and reported with photos, GPS coordinates and the verifier's remarks. Track progress through the status endpoint or a webhook.

Consent. The person is informed of the visit and consents to the check; the consent record accompanies the request.

Typical uses

Employee background checks. Address component of the BGV package.
Secured lending. Residence confirmation for high-ticket loans.

Questions

What is the turnaround?: Three to seven working days depending on location; metros are faster. The digital address check answers in minutes if that is enough.