---
title: "Server routes · vuejs.school"
description: "Write API endpoints in server/api, read params, query strings and bodies safely, answer with the right status, and keep secrets in runtime config."
canonical_url: "https://vuejs.school/learn/nuxt/server-routes"
meta:
  "og:description": "Write API endpoints in server/api, read params, query strings and bodies safely, answer with the right status, and keep secrets in runtime config."
  "og:image": "https://vuejs.school/_og/d/a_~U2VydmVyIHJvdXRlcyDCtyB2dWVqcy5zY2hvb2w%2Cc_OgCard.takumi%2Ctitle_Server%2Broutes%2Cdescription_~V3JpdGUgQVBJIGVuZHBvaW50cyBpbiBzZXJ2ZXIvYXBpLCByZWFkIHBhcmFtcywgcXVlcnkgc3RyaW5ncyBhbmQgYm9kaWVzIHNhZmVseSwgYW5zd2VyIHdpdGggdGhlIHJpZ2h0IHN0YXR1cywgYW5kIGtlZXAgc2VjcmV0cyBpbiBydW50aW1lIGNvbmZpZy4%2Ceyebrow_~TnV4dCDCtyBMZXNzb24gNiBvZiAxMQ%2Ctint_sky%2Cp_Ii9sZWFybi9udXh0L3NlcnZlci1yb3V0ZXMi%2Cs_HKrLRZFDvr0I3x6f.png"
  "og:image:alt": "Server routes · vuejs.school"
  "og:image:height": "600"
  "og:image:type": image/png
  "og:image:width": "1200"
  "og:title": "Server routes · vuejs.school"
  "twitter:image": "https://vuejs.school/_og/d/a_~U2VydmVyIHJvdXRlcyDCtyB2dWVqcy5zY2hvb2w%2Cc_OgCard.takumi%2Ctitle_Server%2Broutes%2Cdescription_~V3JpdGUgQVBJIGVuZHBvaW50cyBpbiBzZXJ2ZXIvYXBpLCByZWFkIHBhcmFtcywgcXVlcnkgc3RyaW5ncyBhbmQgYm9kaWVzIHNhZmVseSwgYW5zd2VyIHdpdGggdGhlIHJpZ2h0IHN0YXR1cywgYW5kIGtlZXAgc2VjcmV0cyBpbiBydW50aW1lIGNvbmZpZy4%2Ceyebrow_~TnV4dCDCtyBMZXNzb24gNiBvZiAxMQ%2Ctint_sky%2Cp_Ii9sZWFybi9udXh0L3NlcnZlci1yb3V0ZXMi%2Cs_HKrLRZFDvr0I3x6f.png"
  "twitter:image:alt": "Server routes · vuejs.school"
---

> Index of every page on this site: [llms.txt](https://vuejs.school/llms.txt)

# **Server routes**

Write API endpoints in server/api, read params, query strings and bodies safely, answer with the right status, and keep secrets in runtime config.

```json
{"@context":"https://schema.org","@graph":[{"@id":"https://vuejs.school/#website","@type":"WebSite","description":"A free AI-instructed school for Vue.js. Short tutorials, runnable code and quizzes that adapt to you.","name":"vuejs.school","url":"https://vuejs.school/","publisher":{"@id":"https://vuejs.school/#identity"}},{"@id":"https://vuejs.school/learn/nuxt/server-routes#webpage","@type":"WebPage","description":"Write API endpoints in server/api, read params, query strings and bodies safely, answer with the right status, and keep secrets in runtime config.","name":"Server routes","url":"https://vuejs.school/learn/nuxt/server-routes","breadcrumb":{"@id":"https://vuejs.school/learn/nuxt/server-routes#breadcrumb"},"isPartOf":{"@id":"https://vuejs.school/#website"},"potentialAction":[{"@type":"ReadAction","target":["https://vuejs.school/learn/nuxt/server-routes"]}],"primaryImageOfPage":{"@id":"https://vuejs.school/#logo"}},{"@id":"https://vuejs.school/#identity","@type":"Organization","description":"A free AI-instructed school for Vue.js. Short tutorials, runnable code and quizzes that adapt to you.","name":"vuejs.school","url":"https://vuejs.school","logo":{"@id":"https://vuejs.school/#logo"}},{"@id":"https://vuejs.school/learn/nuxt/server-routes#article","description":"Write API endpoints in server/api, read params, query strings and bodies safely, answer with the right status, and keep secrets in runtime config.","headline":"Server routes","inLanguage":"en","isAccessibleForFree":true,"thumbnailUrl":"https://vuejs.school/_og/d/a_~U2VydmVyIHJvdXRlcyDCtyB2dWVqcy5zY2hvb2w%2Cc_OgCard.takumi%2Ctitle_Server%2Broutes%2Cdescription_~V3JpdGUgQVBJIGVuZHBvaW50cyBpbiBzZXJ2ZXIvYXBpLCByZWFkIHBhcmFtcywgcXVlcnkgc3RyaW5ncyBhbmQgYm9kaWVzIHNhZmVseSwgYW5zd2VyIHdpdGggdGhlIHJpZ2h0IHN0YXR1cywgYW5kIGtlZXAgc2VjcmV0cyBpbiBydW50aW1lIGNvbmZpZy4%2Ceyebrow_~TnV4dCDCtyBMZXNzb24gNiBvZiAxMQ%2Ctint_sky%2Cp_Ii9sZWFybi9udXh0L3NlcnZlci1yb3V0ZXMi%2Cs_HKrLRZFDvr0I3x6f.png","@type":["Article","TechArticle"],"articleSection":["Routing & data"],"author":{"@id":"https://vuejs.school/#identity"},"image":{"@id":"https://vuejs.school/#/schema/image/1"},"isPartOf":{"@id":"https://vuejs.school/learn/nuxt/server-routes#webpage"},"keywords":["server/api","defineEventHandler()","getQuery()","readValidatedBody()","createError()","useRuntimeConfig(event)"],"mainEntityOfPage":{"@id":"https://vuejs.school/learn/nuxt/server-routes#webpage"},"publisher":{"@id":"https://vuejs.school/#identity"}},{"@id":"https://vuejs.school/learn/nuxt/server-routes#breadcrumb","@type":"BreadcrumbList","itemListElement":[{"@type":"ListItem","name":"Skill tree","item":"https://vuejs.school/track","position":1},{"@type":"ListItem","name":"Nuxt","item":"https://vuejs.school/track/nuxt","position":2},{"@type":"ListItem","name":"Server routes","position":3}]},{"@id":"https://vuejs.school/#logo","@type":"ImageObject","caption":"vuejs.school","contentUrl":"https://vuejs.school/apple-touch-icon.png","inLanguage":"en","url":"https://vuejs.school/apple-touch-icon.png"},{"@id":"https://vuejs.school/#/schema/image/1","@type":"ImageObject","contentUrl":"https://vuejs.school/_og/d/a_~U2VydmVyIHJvdXRlcyDCtyB2dWVqcy5zY2hvb2w%2Cc_OgCard.takumi%2Ctitle_Server%2Broutes%2Cdescription_~V3JpdGUgQVBJIGVuZHBvaW50cyBpbiBzZXJ2ZXIvYXBpLCByZWFkIHBhcmFtcywgcXVlcnkgc3RyaW5ncyBhbmQgYm9kaWVzIHNhZmVseSwgYW5zd2VyIHdpdGggdGhlIHJpZ2h0IHN0YXR1cywgYW5kIGtlZXAgc2VjcmV0cyBpbiBydW50aW1lIGNvbmZpZy4%2Ceyebrow_~TnV4dCDCtyBMZXNzb24gNiBvZiAxMQ%2Ctint_sky%2Cp_Ii9sZWFybi9udXh0L3NlcnZlci1yb3V0ZXMi%2Cs_HKrLRZFDvr0I3x6f.png","inLanguage":"en","url":"https://vuejs.school/_og/d/a_~U2VydmVyIHJvdXRlcyDCtyB2dWVqcy5zY2hvb2w%2Cc_OgCard.takumi%2Ctitle_Server%2Broutes%2Cdescription_~V3JpdGUgQVBJIGVuZHBvaW50cyBpbiBzZXJ2ZXIvYXBpLCByZWFkIHBhcmFtcywgcXVlcnkgc3RyaW5ncyBhbmQgYm9kaWVzIHNhZmVseSwgYW5zd2VyIHdpdGggdGhlIHJpZ2h0IHN0YXR1cywgYW5kIGtlZXAgc2VjcmV0cyBpbiBydW50aW1lIGNvbmZpZy4%2Ceyebrow_~TnV4dCDCtyBMZXNzb24gNiBvZiAxMQ%2Ctint_sky%2Cp_Ii9sZWFybi9udXh0L3NlcnZlci1yb3V0ZXMi%2Cs_HKrLRZFDvr0I3x6f.png"}]}
```