post https://secure.finch-app.com/api/public/v1/title//analysis
Creates and performs a new title analysis on the given title. If the title is not held on file in your cloud, the title can be automatically ordered using HM Land Registry Business Gateway.
Ordering titles is billed by HM Land Registry to the Business Gateway account.
Permissions
The following permissions are required to call this API. Learn more.
| Permission type | Permissions |
|---|---|
| API key action permission | Title |
| Folder access control list permission | Sender |
Remarks
When titles are being ordered from HM Land Registry, the title order may be postponed for processing at their discression. When this occurs, the status of your title analysis will be "Queued". You can then await the "titleAnalysis_ready" webhook for when the title analysis is ready, or you may periodically poll "Get Analysis" (4 hour recommended poll time).