Server Routes

Nuxt automatically scans files inside the ~/server/api directory to register API and server handlers with HMR (Hot Module Reloading) support.

Each file should export a default function defined with defineEventHandler(), which can return JSON data, a Promise, or use event.res.end() to send response. This API can now be called universally using await $fetch('/api/hello').


export default defineEventHandler(() => {
  return {
    message: 'Hello, World!',


<script setup>
let data = await $fetch('/api/hello');

    <div>Returned JSON:</div>
      {{ data }}


Returned JSON:
{ "message": "Hello, World!" }