Skip to main content

About

For professionals

Owlsby for businesses that handle many homes: letting and estate agents, block managers, lenders, valuers, conveyancers and letting platforms.

Who it is for

Any business in the UK handling many homes in England and Wales. Every home you keep gets the same checks, with the same answers, as it would for anyone else: nobody can pay to change what we show.

What the monthly plan holds

One monthly plan holds every home your account keeps, however many - a team's plan holds every home the team keeps. Every home it holds has everything the free one has: every check and change email on it, its record and certificates, a link to share it and Download everything.

What it costs

42p a home a month (35p + VAT), and at least £18 (£15 + VAT) in a month it holds any. We count your account's homes once a day, and each month is billed on the most your account held on any one day, so a home kept and removed between two counts is not counted. A month holding no home costs nothing.

How it is billed

The monthly plan is sold by Lumman Ltd, the company that operates Owlsby, not through Link. It is billed once a month, for the month just gone, on one invoice you can see on Stripe's page, and you set up how you pay there. Until HMRC gives us our VAT number, each invoice shows its total with VAT included and no VAT line, and a VAT invoice for the same total follows, with nothing more to pay.

Read our terms

Starting and cancelling

If your account holds no plan and you're one of its Owners, choose the monthly plan on the Plans page. On a yearly plan, cancel it there first, and choose the monthly plan once it ends. The person who pays for the monthly plan can cancel it on Stripe's page: it runs to the end of its month, and that month's invoice is the last. We don't refund the monthly plan. If an invoice is wrong, tell us at hi@owlsby.com within 30 days of it, and we will correct it by hand, with a refund or by taking it off your next invoice.

Go to Plans

The API

On the monthly plan, one of your account's Owners makes its API key on the Plans page, and we show it once. To look up one home, send a GET request to https://owlsby.com/api/v1/lookup with the home's uprn and postcode as its query, and your key in the Authorization header, after Bearer. The answer is JSON, and names the home by its UPRN and postcode alone.

What an answer holds

Each answer holds these fields. A check that did not answer is null, and the lookup is free.

  • uprn and postcode - the home you asked for.
  • checks - licensing, registration, energy, restrictions (listed buildings and conservation areas), planning (applications within 200 m in the last 12 months, not counting tree work, signs and adverts, or conditions and small changes to earlier permissions), flood and sales.
  • status - on each check that gives a verdict: fine, watch, action or unknown. Planning and sales give facts, so they carry none, and restrictions carries none where it finds nothing.
  • finding - what the check found, in plain words, with its date where it has one.
  • source - every source the finding comes from, and when each was updated or checked; null where it has none.
  • read_at - when we read it.
  • notice - where a source may be out of date, a line saying so.
  • sales - on the sales check, each sale of this home, found through HM Land Registry's link to its UPRN, newest first, with its price in pounds and its month, as 2021-03. Never its address.
  • ready_to_advertise - whether anything public stops this home being advertised to let to one household. Its status is ready, not_yet or check_with_council, and its words say so in full. must_also_hold lists what the landlord must also hold that we can't see, such as a council licence or registration, and reasons what changes for a house share or 5 or more sharers. It never covers gas safety, electrical or deposit certificates.
  • failed - what did not answer: place, where we don't hold that UPRN at that postcode, then each check that did not answer, or ready_to_advertise.
  • charged - whether this lookup was charged.
  • error and message - why a request was refused, as a code and in words: no_key, unknown_key, replaced_key, not_on_monthly_plan, bad_request, busy or daily_limit_reached.

What a lookup costs

42p (35p + VAT) for each charged lookup, on the monthly plan's invoice. A lookup is charged only when we place the home at its postcode and every check and ready_to_advertise answer, and the same home asked again on the same day, London time, is charged once.

The daily limit

Your account can make 1,000 charged lookups a day, London time, unless you ask us at hi@owlsby.com and we raise it. Past that, the API answers daily_limit_reached, free, until midnight. Your account's Owners get one email the first time a day passes 800. Too many requests at once from one key are refused with busy - try again shortly.

Case PDFs

From a home's report, anyone in your account but View-only members can make a case PDF: every check on the home and whether anything public stops it being advertised to let, with their sources, named by your own case reference and its UPRN and postcode - never its address - and dated. Your account keeps each one on its Case PDFs page, where anyone in the account can open it. Each case PDF costs £30 (£25 + VAT), on the monthly plan's invoice. One we can't make is not charged.

A weekly email

Every Monday morning, everyone keeping two or more homes a plan holds gets one email of what needs doing across them: the homes with a date overdue or due within 30 days, soonest first and by team, and how many certificates wait to be filed and to be confirmed. A week with nothing to do sends nothing, and anyone can switch it off in Account settings.