{"openapi":"3.1.0","info":{"title":"India Property Register API","version":"1.0.0","description":"Prepaid API (sign up at https://indiapropertyregister.com/signup for ₹50 of free credit, then ₹0.16 per successful call; HTTP 402 insufficient_balance when the wallet is empty; agents: https://indiapropertyregister.com/auth.md; docs at https://indiapropertyregister.com/api/docs) to the land and property register of India: every state, district, tehsil and village with LGD codes, boundaries (GeoJSON) and pincodes; how each state keeps its land records and the government portals that hold them; plot records as they are loaded. Revenue records are not proof of title and nothing returned is a certified copy. Use is governed by the data licence (https://indiapropertyregister.com/terms#licence): your own business use, commercial included, and showing individual records to your users are allowed; resale, redistribution, competing databases and AI training need written permission.","contact":{"email":"support@indiapropertyregister.com"},"license":{"name":"India Property Register data licence","url":"https://indiapropertyregister.com/terms#licence"}},"servers":[{"url":"https://indiapropertyregister.com/api/v1"}],"security":[{"bearer":[]},{"apiKey":[]},{"oauth":["api"]}],"paths":{"/search":{"get":{"summary":"Find villages, tehsils, districts and states by name, or the villages in a 6-digit pincode","operationId":"searchPlaces","parameters":[{"name":"q","in":"query","required":true,"schema":{"type":"string","minLength":3},"example":"Rampur"},{"name":"limit","in":"query","schema":{"type":"integer","minimum":1,"maximum":50,"default":20}}],"responses":{"200":{"description":"Matches by kind"},"400":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/states":{"get":{"summary":"All states and union territories with LGD codes and counts","operationId":"listStates","responses":{"200":{"description":"States"}}}},"/state/{lgd}/districts":{"get":{"summary":"Districts of a state","operationId":"listDistricts","parameters":[{"name":"lgd","in":"path","required":true,"schema":{"type":"integer"},"description":"LGD state code","example":9}],"responses":{"200":{"description":"Districts"},"404":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/district/{lgd}/tehsils":{"get":{"summary":"Tehsils (talukas, mandals, circles) of a district","operationId":"listTehsils","parameters":[{"name":"lgd","in":"path","required":true,"schema":{"type":"integer"},"description":"LGD district code","example":158}],"responses":{"200":{"description":"Tehsils"},"404":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/tehsil/{lgd}/villages":{"get":{"summary":"Villages of a tehsil","operationId":"listVillages","parameters":[{"name":"lgd","in":"path","required":true,"schema":{"type":"integer"},"description":"LGD sub-district code","example":780}],"responses":{"200":{"description":"Villages"},"404":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/village/{lgd}":{"get":{"summary":"One village: codes, hierarchy, pincode, area, centre point, neighbours, land-record sources and plots; boundary as GeoJSON with geometry=geojson","operationId":"getVillage","parameters":[{"name":"lgd","in":"path","required":true,"schema":{"type":"integer"},"description":"LGD village code","example":125245},{"name":"geometry","in":"query","schema":{"type":"string","enum":["geojson"]}}],"responses":{"200":{"description":"Village","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Village"}}}},"404":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/pincode/{pin}":{"get":{"summary":"A pincode area and the villages inside it","operationId":"getPincode","parameters":[{"name":"pin","in":"path","required":true,"schema":{"type":"string","pattern":"^[1-9][0-9]{5}$"},"example":"244901"}],"responses":{"200":{"description":"Pincode"},"404":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/sources":{"get":{"summary":"Government sources for land and property records, with access details; with state, also how that state keeps its land records (record names, hierarchy, glossary)","operationId":"listSources","parameters":[{"name":"state","in":"query","schema":{"type":"integer"},"description":"LGD state code"},{"name":"layer","in":"query","schema":{"type":"string","enum":["ror","map","registration","ec","rera","circle_rate","tax","property_card","notice","charge","court","revenue_court","acquisition","restricted","geo","programme"]}}],"responses":{"200":{"description":"Sources"}}}},"/stats":{"get":{"summary":"Coverage counts","operationId":"stats","responses":{"200":{"description":"Counts"}}}},"/village/{lgd}/plots":{"get":{"summary":"Find a plot by its number in a village (plot=123/2A), or list every plot of the village","operationId":"findPlot","parameters":[{"name":"lgd","in":"path","required":true,"schema":{"type":"integer"},"description":"LGD village code","example":125245},{"name":"plot","in":"query","schema":{"type":"string"}}],"responses":{"200":{"description":"Plots"},"404":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/plot/{ipr_id}":{"get":{"summary":"Everything the register holds about a plot: holders, mutations, deeds, charges, tax, cases, notices, restricted land, government rate","operationId":"getPlot","parameters":[{"name":"ipr_id","in":"path","required":true,"schema":{"type":"string","pattern":"^P[0-9A-F]{16}$"}},{"name":"geometry","in":"query","schema":{"type":"string","enum":["geojson"]}}],"responses":{"200":{"description":"Plot"},"404":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/owners/search":{"get":{"summary":"Plots by published holder name, optionally within a state or district","operationId":"searchOwner","parameters":[{"name":"name","in":"query","required":true,"schema":{"type":"string","minLength":3}},{"name":"state","in":"query","schema":{"type":"integer"}},{"name":"district","in":"query","schema":{"type":"integer"}},{"name":"limit","in":"query","schema":{"type":"integer","maximum":100}}],"responses":{"200":{"description":"Matches"}}}},"/village/{lgd}/rates":{"get":{"summary":"Government land rates of a village (circle rate, guideline value, jantri, ready reckoner, DLC)","operationId":"getVillageRates","parameters":[{"name":"lgd","in":"path","required":true,"schema":{"type":"integer"},"description":"LGD village code","example":125245}],"responses":{"200":{"description":"Rates"},"404":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/village/{lgd}/layers":{"get":{"summary":"Restricted and notified land, land acquisition and programme progress for a village","operationId":"getVillageLayers","parameters":[{"name":"lgd","in":"path","required":true,"schema":{"type":"integer"},"description":"LGD village code","example":125245}],"responses":{"200":{"description":"Layers"},"404":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/coverage":{"get":{"summary":"What the register holds, by state and kind of record","operationId":"getCoverage","parameters":[{"name":"state","in":"query","schema":{"type":"integer"}}],"responses":{"200":{"description":"Coverage"}}}},"/account":{"get":{"summary":"Your account: wallet balance, price per call, calls remaining, top-up packs (free)","operationId":"getAccount","responses":{"200":{"description":"Account"},"401":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/account/topup":{"post":{"summary":"Start a wallet top-up of ₹500, ₹5,000 or ₹50,000 (+18% GST). Returns pay_url for the account owner to pay, and status_url (free)","operationId":"topUp","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["amount"],"properties":{"amount":{"type":"integer","enum":[500,5000,50000]}}}}}},"responses":{"201":{"description":"Pending payment with pay_url"},"400":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/account/payments/{id}":{"get":{"summary":"A top-up: pending, paid or expired (free)","operationId":"getPayment","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"integer"}}],"responses":{"200":{"description":"Payment"},"404":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/account/usage":{"get":{"summary":"Your most recent calls, with what each was billed (free)","operationId":"getUsage","parameters":[{"name":"limit","in":"query","schema":{"type":"integer","minimum":1,"maximum":500,"default":50}}],"responses":{"200":{"description":"Calls"}}}}},"components":{"securitySchemes":{"bearer":{"type":"http","scheme":"bearer","description":"API key of your India Property Register account (https://indiapropertyregister.com/signup)"},"apiKey":{"type":"apiKey","in":"header","name":"X-API-Key"},"oauth":{"type":"oauth2","flows":{"authorizationCode":{"authorizationUrl":"https://indiapropertyregister.com/oauth/authorize","tokenUrl":"https://indiapropertyregister.com/oauth/token","refreshUrl":"https://indiapropertyregister.com/oauth/token","scopes":{"api":"Use the API, billed to the wallet"}}}}},"schemas":{"Error":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"docs":{"type":"string"}}},"Village":{"type":"object","properties":{"lgd":{"type":"integer"},"name":{"type":"string"},"census2011":{"type":["string","null"]},"pincode":{"type":["string","null"]},"area_hectares":{"type":["number","null"]},"centre":{"type":["object","null"],"properties":{"lat":{"type":"number"},"lon":{"type":"number"}}},"state":{"type":"object"},"district":{"type":"object"},"tehsil":{"type":["object","null"]},"block":{"type":["object","null"]},"gram_panchayat":{"type":["object","null"]},"plots":{"type":"integer"},"neighbours":{"type":"array","items":{"type":"object"}},"land_record_sources":{"type":"array","items":{"type":"object"}},"geometry":{"type":"object","description":"GeoJSON MultiPolygon (only with geometry=geojson)"},"url":{"type":"string"},"note":{"type":"string"}}}}}}