---
title: "Approvals by street, address or name"
method: POST
path: "/api/v1/tools/approval_identifier_search"
---

# Approvals by street, address or name

`POST /api/v1/tools/approval_identifier_search`

## Request

- Base URL: `https://verified.realestate`
- URL: `https://verified.realestate/api/v1/tools/approval_identifier_search`
- Auth: HTTP bearer

Search the consolidated approvals register (CMDA, DTCP, panchayats, RERA) by what is written on the permit rather than by the land: street, locality, plot or door number, PIN code, village, block, ward, the applying party or promoter, a permit number, the authority, the kind of approval, or a year range. Use when there is no survey number, or when the question is about a street, an address or a promoter. Filters combine with AND and at least one is required. NOT for "what is approved on this survey number or at this pin", which is the separate reverse approval lookup by survey. Costs 1 to 4 credits per call. A search that carries a permit or approval number costs 1 credit; a search by street, locality, village, plot, door, PIN code or name alone costs 4 credits. Waived when nothing is found.

## Request body

- object
  - `street` string: Street or road name, e.g. "4th Avenue".
  - `locality` string: Locality or neighbourhood, e.g. "Anna Nagar".
  - `village` string: Revenue village or town.
  - `plot` string: Plot number as written on the permit.
  - `door` string: Door or house number.
  - `pincode` string: Six digit PIN code.
  - `block` string: Block number.
  - `ward` string: Ward number.
  - `party` string: Applicant, owner or promoter named on the permit.
  - `permit_number` string: Permit, approval or file number, whole or partial.
  - `authority` string: Issuing authority, e.g. CMDA, DTCP, RERA.
  - `kind` string: Kind of record, e.g. layout, building, completion_certificate.
  - `year_from` integer: Earliest permit year.
  - `year_to` integer: Latest permit year.

## Response `200`

The envelope: ok, status, data, credits_charged, balance_after, request_id

## Other responses

- `401`: No valid credential
- `402`: Not enough credits
- `429`: Rate limit

---

[API](https://skmtc.dev/verified/apis/landlens-tool-api.md) · [All operations](https://skmtc.dev/verified/apis/landlens-tool-api/llms.txt) · [OpenAPI document](https://skmtc.dev/verified/apis/landlens-tool-api/revisions/7923c1c24431?raw)