- An API (Application Programming Interface) is a defined way for one piece of software to ask another piece of software for something — and get something back.
- Think of it like a restaurant: you don't walk into the kitchen. You tell the waiter (the API) what you want, and the waiter carries your order to the kitchen and brings back your food.
- APIs let a business connect systems it already has — a website, a CRM, a payment processor — without rebuilding any of them from scratch.
- "Does it have an API?" is one of the first questions we ask in a discovery call, because the answer determines what's actually possible.
- This is the first post in a short series translating common software terms into plain English for business owners.
A lot of our clients come to us with an idea and not much else — no technical background, no development team, sometimes not even a clear sense of what's possible. So when I'm asking questions to understand a project, I've learned I usually can't just ask the question. I have to explain what I'm even asking first.
"Does that platform have an API?" is one I ask constantly. And for a long time, my instinct was to answer it the way it was taught to me: "API — Application Programming Interface."
That gets me a blank, slightly confused look every time. Which makes sense — knowing what the letters stand for doesn't actually tell you anything. So somewhere along the way I stopped explaining APIs that way entirely, and started explaining them through something every client already understands: owning a restaurant.
01 — The short answer
What Is an API in Simple Terms?
An API is a defined way for one piece of software to ask another piece of software for something — and get something back. That's the whole concept. Everything else is detail.
IBM's technical definition describes an API as a set of rules that lets applications exchange data and functionality with each other. AWS puts it similarly: two applications communicating through defined requests and responses. Both are accurate. Neither one would have gotten me anything but that same blank look.
Here's the version I actually use with clients:
"An API is a defined way for one piece of software to ask another piece of software for something."
If that sentence is all you take from this article, you already understand APIs better than most people who use the word casually in meetings. But the restaurant is what actually makes it stick, so let me walk you through it the way I walk clients through it.
02 — The analogy
The Restaurant Analogy
When you own a restaurant, there are three things going on at once.
There's the kitchen — where the actual cooking happens. Nobody eating at their table can see it, but it's where all the real work gets done. In software, we'd call that the backend.
There's the front — the dining room, the branding, the name over the door, the whole experience a customer walks into. That's what controls how the client feels about the restaurant, and it's got almost nothing to do with what's happening in the kitchen. In software, that's the frontend.
And then there's the staff standing between them — specifically, the waiter. A customer sits down, tells the waiter what they want, and the waiter carries that order back to the kitchen. Once the meal is ready, the waiter brings it back out. The customer never goes into the kitchen. The kitchen never talks to the customer directly. Everything passes through the waiter.
That waiter is the API.
Once a client has that picture — kitchen, front, waiter — the rest of the analogy tends to click fast:
| At the Restaurant | In the Software |
|---|---|
| Customer | User |
| Dining room | Frontend |
| Menu | API documentation |
| Order | Request |
| Waiter | API |
| Kitchen | Backend |
| Pantry / food storage | Database |
| Finished meal | Response |
| "Sorry, we're out of that" | Error response |
| Employee-only kitchen access | Authentication / permissions |
The one part worth being precise about: the waiter isn't just a messenger. A good waiter also knows the menu — what can and can't be ordered, how a request needs to be phrased, what substitutions are allowed. That's the more complete version of an API: not just the thing that carries your request, but the set of rules for what requests are even valid in the first place.
03 — Reading the menu
The Menu Matters Too
A waiter can't bring you something the kitchen doesn't make. In software terms: an API only supports the specific requests it was built to handle, and that list is written down in something called API documentation — the technical menu.
This is a genuinely useful distinction for a business owner to have, because it's one of the first things we have to determine during a discovery conversation: does the system you want to connect to actually have an API, and does that API's "menu" include the specific thing you're trying to do?
Having an API doesn't automatically mean an integration can do everything you'd like. Sometimes the menu is short. Sometimes what you want isn't on it at all.
04 — Why one API can serve many things
One Kitchen Can Serve Many Dining Rooms — And One Restaurant Can Use Many Kitchens
Restaurants extend the analogy further than most people take it, and this is where it stops being a beginner's explanation and starts being a genuinely useful way to think about software architecture.
A single kitchen can serve the dining room, an online ordering system, a delivery app, and a catering operation, all at once, all through the same underlying kitchen. Your software works the same way: a website, a mobile app, and an internal admin portal can all talk to the same backend through the same API. Which combination makes sense for you really just depends on the front-end experience you want to give your customers — the kitchen doesn't have to change at all to support any of it.
Now flip it around. A restaurant doesn't have to grow its own vegetables, raise its own cattle, or bake its own bread — it can order those ingredients from outside suppliers. Your software doesn't have to build its own payment processor, its own mapping system, or its own CRM from scratch. It can talk to Stripe, Google Maps, or HubSpot through their APIs instead.
That second pattern — using outside APIs instead of building everything in-house — is where most custom software gets built today. It's also where a business's software budget goes furthest: paying for access to a mature, secure, already-built system usually costs far less than building an equivalent one from nothing.
05 — A real example
A Real-World API Example: Subscription Billing
Here's a walk-through using something we build often: a subscription checkout that runs on Recurly.
A customer clicks "Subscribe" on your website. Your application sends that subscription request through Recurly's API. Recurly processes the billing — charges the card, sets up the recurring schedule, handles the subscription logic — and sends a response back through the same API. Your application reads that response and tells the customer: "Your subscription is active."
The customer never sees Recurly directly. From where they're sitting, they clicked one button on your site and got confirmation a second later. The API is the entire mechanism connecting those two moments, and it's invisible unless something breaks.
06 — Why this matters for your business
Why APIs Matter When You're Building or Buying Software
This is where the concept stops being trivia and starts affecting decisions you actually make. APIs are how a piece of software can:
- Connect systems you already use instead of replacing them
- Eliminate manual, duplicate data entry between platforms
- Automate a workflow that currently depends on someone copying and pasting
- Process payments through an established, secure provider
- Keep a website and a CRM in sync without a person in the middle
- Add a mobile app around a backend you already have, instead of rebuilding it
- Extend what your software does without touching what already works
Every one of those is a project we get asked to scope, whether it starts as a system integration question or a custom software development one. And the very first question in almost all of them is the same one I opened this article with.
07 — What we actually ask
"Does It Have an API?"
When a client tells us, "We need our website to talk to our CRM," the next question is never about design or timeline. It's: which CRM, and does it have an API?
From there, the questions get more specific — this is roughly the checklist running in the background of that conversation:
The Discovery-Call API Checklist
- Is there an API at all?
- Is it documented, and is that documentation current?
- What data does it expose — and what does it withhold?
- Can we only read data, or can we also write it?
- Does it support webhooks, or does someone have to poll for updates?
- How does authentication work, and who controls access?
- Are there rate limits or usage caps that affect how we can use it?
- Does API access require a higher-tier subscription on their end?
- Is the sync one-way or two-way?
- Which system is the source of truth when the two disagree?
None of that is exotic. It's the ordinary due diligence behind every integration project — and it's exactly why "does it have an API" is worth asking before you commit budget to a build.
08 — When there isn't one
What Happens if Software Doesn't Have an API?
Sometimes the answer to "does it have an API" is no — and that doesn't automatically end the project. There are usually alternatives, though each comes with tradeoffs:
- Webhooks — the other system pushes updates to you instead of you asking for them
- Scheduled file imports and exports — slower and less real-time, but often reliable
- Direct database access — powerful, but fragile if the vendor changes their schema
- Middleware — a translation layer built between two systems that don't speak the same language
- Vendor-built integrations — a pre-built connector the software provider already maintains
- Browser automation — simulating a human clicking through the other system's interface, as a last resort
Sometimes none of those are practical, and the honest answer is that a clean integration isn't currently possible. That's a better answer to get during a discovery call than three weeks into a build.
09 — A related distinction
API vs. Integration: What's the Difference?
These two get used interchangeably, but they mean different things.
"The API is the ability to communicate. The integration is the relationship you've actually built using it."
- The mechanism — the rules for how one piece of software can talk to another
- Built and maintained by the platform you're connecting to
- Exists whether or not anyone ever uses it
- The "menu": what requests are valid and what they return
- What a developer builds using that mechanism
- Configured for your specific data and your specific workflow
- Depends entirely on an API existing in the first place
- The actual working connection between your CRM and your website
Every integration depends on an API existing. Not every API results in an integration being built.
10 — Where this series goes next
Other Software Terms You'll Hear
API is one of dozens of terms that get thrown around in a software conversation as if everyone in the room already knows them. Frontend, backend, tech stack, sprint, scope creep, technical debt — most business owners have heard all of these and could not confidently define any of them.
That's the idea behind this series: short, plain-English explanations of the vocabulary you'll actually run into while building or buying software, written so you can walk into your next development conversation and follow along — not so you can write the code yourself.
The next post in the series is a broader glossary covering the terms business owners hear most often across planning, development, and deployment: Software Development Terms Every Business Owner Should Know.
11 — Common questions
Quick Answers
What does API stand for?
API stands for Application Programming Interface. The name is accurate but not very descriptive — it's more useful to think of an API as a defined way for one piece of software to request something from another piece of software.
What is an API in simple terms?
An API is a set of rules that lets two pieces of software communicate. One system sends a request, the API carries it to the other system, and a response comes back — similar to a waiter carrying an order between a customer and a kitchen.
What is an example of an API?
A common example is a subscription checkout: when a customer subscribes on a website, the site's software sends that request through a billing provider's API (such as Recurly or Stripe), which processes the payment and sends back a confirmation.
What is the difference between an API and an integration?
An API is the mechanism that makes communication between two systems possible. An integration is the actual connection a developer builds using that API — configured for a specific business's data and workflow.
Does every piece of software have an API?
No. Many platforms have public, well-documented APIs, but some older or more limited systems don't expose one at all. When that's the case, alternatives like webhooks, file imports, or middleware are sometimes used instead, though each comes with tradeoffs.
Are APIs secure?
APIs can be built securely, but security depends on how they're implemented — authentication requirements, access permissions, and rate limits all affect how safe an API is to use. A reputable provider like Stripe or HubSpot invests heavily in API security; a custom or poorly maintained API may not.
Does using an API cost money?
It depends on the provider. Many APIs are free to use up to a certain volume and charge based on usage past that point. Some require a paid subscription tier before API access is available at all.
Every software project eventually runs into the same question: does the system you're trying to connect to have an API, and can it actually do what you need? Getting an honest answer to that question early is usually the difference between a smooth integration and an expensive surprise.
If you're planning a project that involves connecting systems — a website to a CRM, an app to a payment processor, or anything in between — that's exactly the kind of question a Virgo Development Discovery Session is built to answer. We'll look at what you're trying to connect, confirm what's actually possible, and give you a realistic picture of the build. Ready to talk it through? Book a Discovery Call with me and the team.
Jamie Lords ↗ LinkedIn is CEO of Virgo Development and teaches Business and Marketing at Southern New Hampshire University. The restaurant analogy in this post comes from years of actual discovery calls with founders and startups who needed the jargon translated before the real conversation could start. This is the first post in a planned "Software in Plain English" series doing the same for the rest of the vocabulary.