What is an API endpoint?
An API endpoint is a specific address, usually a URL, where an API accepts a request and sends back a response. An API can expose many endpoints, and each one handles one job. A weather service might have one endpoint for the current forecast and another for historical data. You call the endpoint, pass any details it needs, and it returns the result.
In practice an endpoint combines a URL path with an action. GET /users/42 asks for the user with ID 42, while POST /users creates a new one. The path says what you are working with, and the method (GET, POST, PUT, DELETE) says what you want to do with it.
In plain words
Think of a company switchboard. The API is the whole company, and each endpoint is a direct extension. Dial the sales extension and you reach sales; dial billing and you reach billing. You do not call "the company" in general. You call the exact extension for the thing you need, and that desk answers.
Why it matters
- It is where integration actually happens. Connecting two systems means calling each other's endpoints. They are the concrete touchpoints behind any integration.
- One endpoint, one job. Clear, well-named endpoints make an API easy to learn and hard to misuse.
- It sets the contract. Each endpoint defines what data it expects and what it returns, which is what developers build against.
Common pitfalls
- Confusing the endpoint with the whole API. The API is the full service; an endpoint is one address within it. A typical API has many.
- Wrong method on the right path. Sending
GETwhere the endpoint expectsPOSTfails, even with a correct URL. Path and method go together. - No versioning. Changing an endpoint's behaviour without a version like
/v2/breaks every caller relying on the old one. Version before you change. - Leaking endpoints without auth. An endpoint reachable on the internet without authentication is an open door. Protect anything that touches real data.
Related articles:
- What is an API? - The bigger picture: how software talks to other software.
- What is a REST API? - The most common style for organising endpoints around resources.
- What is an API gateway? - The single front door that routes traffic to many endpoints.
Want to stay one step ahead?
Don't miss our best insights. No spam, just practical analyses, invitations to exclusive events, and podcast summaries delivered straight to your inbox.