---
[](https://packagephobia.com/result?p=next-api-handler)
[](https://circleci.com/gh/Howard86/next-api-handler/tree/main)
[](https://codecov.io/gh/Howard86/next-api-handler)
[](https://dashboard.cypress.io/projects/d5185e/runs)
## Lightweight and Portable [Next.js](https://nextjs.org) API builder
Building RESTful API routes in [Next.js](https://nextjs.org) with middleware support, predictable error handling and type-safe interfaces for client-server communication.
> Visit [https://next-api-handler.vercel.app](https://next-api-handler.vercel.app) to view the full documentation.
## Getting Started
**TL;DR**
```sh
npm install next-api-handler # or yarn, pnpm
```
```ts
// in /pages/api/users.ts
import { RouterBuilder, ForbiddenException } from 'next-api-handler';
import { createUser, type User } from '@/services/user';
const router = new RouterBuilder();
router
.get(() => 'Hello World!')
.post(async (req) => createUser(req.body))
.delete(() => {
throw new ForbiddenException();
});
export default router.build();
```
## License
[MIT](/LICENSE)
