The Business Facts & Booking API
One free, open standard so any person — or any AI agent working for a person — can ask a business the basic questions and get a straight answer.
The problem
The most basic facts about a business — is it still there, is it open right now, what are the happy hour specials, can I book a table — are locked behind phone tag. Published numbers ring dead lines. Published emails bounce. Phone trees are built to make you give up. A human calling ahead to confirm a restaurant is open is doing useful work; an AI agent calling on that person’s behalf gets hung up on for how its voice sounds. Neither should be necessary for facts a business could simply publish once, in a format machines can read.
The build
Design and ship an open standard — a small set of endpoints any business can publish at a
well-known address (for example, theirdomain.com/.well-known/business) —
plus a free reference implementation a one-person shop can turn on in an afternoon.
| Endpoint | Answers | Notes |
|---|---|---|
GET/facts |
Name, address, hours, open right now, still in business | The five facts nobody should have to phone for |
GET/contact |
A phone number and email that actually reach the business | Verified working — see Challenge № 002 |
GET/specials |
Today’s specials, happy hour, closures, changes | Timestamped, so agents know it’s current |
POST/reservations |
Book, change, or cancel a reservation or appointment | Returns a real confirmation code |
GET/services |
What the business offers, prices where public, accessibility info | Plain structured data — JSON is fine |
The policy pair
- Safe harbor: a business that publishes a working API has done its part — agents query the API instead of calling, and the business is protected from agent call volume.
- No API, no hang-up: where no API exists, an AI voice calling briefly and politely on a person’s behalf must be treated like the person calling. Hanging up on the voice is refusing the person behind it — for a disabled caller who speaks through AI, that is discrimination.
- Not spam: a short, purposeful call — confirm the business is open, check a special, book the table — is the opposite of spam. The standard should say so, in writing.
What “done” looks like A published spec anyone can implement, one free open-source reference server, and the first ten real businesses live on it — a diner, a barber, a repair shop — answering machines and people alike.