---
title: "Order a certified copy"
method: POST
path: "/api/v1/tools/certified_copy"
---

# Order a certified copy

`POST /api/v1/tools/certified_copy`

## Request

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

Order the OFFICIAL certified copy of any registered document (sale deed, gift deed, settlement, mortgage, release...) from the SRO, straight from chat: pass the document number, year and the SRO (10 credits, user must approve; if the registration department confirms it holds no such deed under that number, year and book, the credits are returned automatically; if the copy cannot be fetched automatically for any other reason our team obtains it by hand, and it is not refunded). When the user has UPLOADED a document and asks "is this original / genuine / tampered", set verify_against_upload=true: the certified copy is then automatically COMPARED against their upload and the authenticity verdict posts into the chat. Resolve the SRO first (from the document fields, or the free SRO lookup at the parcel) - the SRO CODE is required to order. Returns a proposal, nothing is charged yet; it runs only once the user approves it, and the approved run costs 10 credits.

## Request body

- object
  - `document_no` string, required: Registration document number, e.g. "4959" (or "4959/2020")
  - `year` string, required: Registration year, e.g. "2020"
  - `sro_code` string: SRO code (e.g. "20066" or "20066:1"). REQUIRED to order; resolve it first.
  - `sro_name` string: SRO name, for display
  - `verify_against_upload` boolean: true when the user asks if their UPLOADED document is original/genuine: the certified copy will be compared against the upload.

## 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)