Development · English usage comparison
Endpoint vs API: English Usage Guide for IT Professionals
An API is the entire interface a service exposes — the contract between two systems. An endpoint is one specific URL in that API. The API is the collection; an endpoint is a single member. Confusing them is a common error in non-native English technical writing.
Side-by-side comparison
| Aspect | Endpoint | API |
|---|---|---|
| Scope | One specific URL/route | The entire service interface |
| Example | POST /api/v1/users | The Users API (all user operations) |
| Plural | "endpoints" (multiple routes) | "APIs" (multiple services/interfaces) |
| Grammar | "Call the endpoint", "hit the endpoint" | "Use the API", "consume the API" |
Example sentences
Endpoint
- "The POST /api/v1/orders endpoint creates a new order and returns 201 Created."
- "This endpoint requires an Authorization header with a valid bearer token."
API
- "We integrated with the Stripe API to handle payments."
- "The public API exposes twelve endpoints for managing user accounts."
Exercises: choose the correct English usage
Select the best answer for each question, then check your reasoning.
1. "The ___ has 20 routes, including GET /users and DELETE /users/:id." Which word?
Explanation: The collection of routes = the API. Each individual route is an endpoint.
2. "I need to call the ___ that returns a list of orders." Which word?
Explanation: A single URL/route is an endpoint.
3. Which sentence is correct English?
Explanation: You integrate with an API (the full service). "Stripe API" is the correct collocation.
4. "This ___ is rate-limited to 100 requests per minute." Which word?
Explanation: Both work here. Rate limits can apply to a single endpoint or the whole API.
5. Which is the correct plural?
Explanation: "Endpoints" (no hyphen, no apostrophe) is the correct plural.
Frequently asked questions
What is a REST endpoint?
A URL combined with an HTTP method (GET /users, POST /users) that the server handles. Each combination is a distinct endpoint.
Can an API have just one endpoint?
Yes — a GraphQL API typically has a single endpoint (POST /graphql) through which all queries and mutations pass.
What is an "API gateway"?
A single entry point for multiple backend services — handles routing, authentication, rate limiting, and logging before forwarding requests to the correct service.
What is "API versioning"?
Including a version number in the URL (/v1/, /v2/) or header so clients can use a stable API version while you evolve a newer one.
What does "consume an API" mean?
"Consume" means to use an API from a client perspective. "We consume the GitHub API" = our code calls it.
What is a "private API" vs "public API"?
A public API is documented and accessible to external developers. A private API is for internal use only — not documented publicly.
What is an "SDK"?
Software Development Kit — a library that wraps an API, making it easier to call from a specific language without writing raw HTTP requests.
What does "API contract" mean?
The formal definition of what an API expects (request format, auth) and returns (response format, status codes). Changing the contract is a "breaking change".
What is "endpoint discovery"?
Finding available API endpoints — through documentation, OpenAPI specs, or tools like Swagger UI that list all routes.
What is a "webhook endpoint"?
A URL on your server that receives HTTP POST calls from a third-party service when events occur (e.g. GitHub calling your /webhooks/github when code is pushed).