A bot that waits for your passport so you don't have to

When our family applied for a Ukrainian passport at the consulate, the paperwork came with a certificate: a sheet with a box on it, a number inside the box, a QR code beside it. That number tells you where the application stands — data sent for verification, document produced, document arrived at the consulate.

There is exactly one way to check it: by hand. You open the ministry's site, type the number, press "Search" and look at a table. The site sends nothing and remembers nothing: close the tab and you start over. The QR code, against all expectation, just leads to the home page, and the input field refuses pasted text — you type the number out every single time.

Now multiply that by the waiting period. Ours took almost two months from "application submitted" to "document issued", and the longest step — the one after which the passport travels to the consulate — can drag on for weeks. For all that time, the only way not to miss the moment is to open the site and type the number. Every day. Knowing that 99 times out of 100 it will say exactly what it said yesterday.

I didn't care for that arithmetic, so I built a bot: @MFApassport_bot.

What it's like to use

You open the bot, press Start and send it the number from the box on your certificate. It replies with everything known about the application right now: the statuses and their dates.

Then it goes quiet.

Once a day, in the evening, the bot checks your application for you. If nothing has changed, you hear nothing — no "check complete, no changes". A message arrives only when a new status appears: the new line is flagged, and the whole history sits underneath it so you don't have to remember what came before.

When "document issued" shows up, the bot sends one last message and unsubscribes you itself. There is nothing left to watch.

The rest is what you'd expect: /list shows your applications with an unsubscribe button, you can follow several at once, and several people can follow the same one — handy when a whole family is waiting. The bot speaks Ukrainian.

The fine print

The bot is free and has nothing to do with the ministry. It's a private little thing that reads the same page you would, only on time and without you. Of your data it keeps the application number, your Telegram chat id and the statuses it has already told you about, so it doesn't repeat itself; all of it disappears when you unsubscribe. Details are in the privacy policy.

Do look after that number: it shows your application's status to anyone who has it. Don't post it in group chats or forums — the bot is the only one that needs it.

The best part of this story isn't the technology, it's the feeling. While you wait for a document, it runs in your head as a background process: did I check today, should I check again. The bot takes that process off your hands. The passport still takes exactly as long as it takes — you just don't have to think about it any more. You'll be told.