Validation error response formatting in Express

Introduction

We format validation error responses to clearly tell users what went wrong with their input. This helps users fix mistakes easily.

When a user submits a form with missing or wrong data.

When an API receives invalid input parameters.

When you want to give clear feedback on what fields need correction.

When you want to keep your API responses consistent and easy to understand.

Syntax

Express

res.status(400).json({
  errors: [
    { field: 'fieldName', message: 'Error message' }
  ]
});

Use HTTP status code 400 for bad requests caused by validation errors.

Return an array of error objects so users can see all problems at once.

Examples

This example shows a single validation error for a missing email field.

Express

res.status(400).json({
  errors: [
    { field: 'email', message: 'Email is required' }
  ]
});

This example shows multiple validation errors returned together.

Express

res.status(400).json({
  errors: [
    { field: 'password', message: 'Password must be at least 8 characters' },
    { field: 'username', message: 'Username cannot contain spaces' }
  ]
});

Sample Program

This Express server has a POST /register route. It checks if email and password are valid. If not, it sends back a 400 status with a list of errors. If all is good, it sends a success message.

Express

import express from 'express';
const app = express();
app.use(express.json());

app.post('/register', (req, res) => {
  const { email, password } = req.body;
  const errors = [];

  if (!email) {
    errors.push({ field: 'email', message: 'Email is required' });
  }
  if (!password || password.length < 8) {
    errors.push({ field: 'password', message: 'Password must be at least 8 characters' });
  }

  if (errors.length > 0) {
    return res.status(400).json({ errors });
  }

  res.status(200).json({ message: 'Registration successful' });
});

app.listen(3000, () => console.log('Server running on port 3000'));

Important Notes

Always use clear and simple messages so users understand what to fix.

Keep the error response structure consistent across your API.

Summary

Validation error responses help users fix input mistakes.

Use HTTP 400 status and return an array of error objects.

Clear messages and consistent format improve user experience.

Practice

1. What HTTP status code is typically used to indicate validation errors in an Express API response?

easy

A. 400 Bad Request

B. 200 OK

C. 500 Internal Server Error

D. 404 Not Found

Solution

1. Step 1: Understand HTTP status codes for client errors

   Validation errors occur when the client sends bad data, so a 4xx code is appropriate.

2. Step 2: Identify the specific code for bad input

   400 Bad Request is the standard code for invalid input from the client.

3. Final Answer:

   400 Bad Request -> Option A

4. Quick Check:

   Validation errors use 400 status [OK]

Hint: Validation errors always use 400 status code [OK]

Common Mistakes:

• Using 200 OK for validation errors
• Confusing 500 Internal Server Error with validation errors
• Using 404 Not Found for input mistakes

2. Which of the following is the correct way to send a JSON validation error response in Express?

easy

A. res.status(400).send('Validation failed')

B. res.json({ error: 'Validation error' })

C. res.status(400).json({ errors: [{ msg: 'Invalid input' }] })

D. res.sendStatus(200)

Solution

1. Step 1: Use status 400 for validation errors

   The response must have status 400 to indicate a client error.

2. Step 2: Format the response as JSON with an errors array

   Returning an object with an errors array containing message objects is the standard pattern.

3. Final Answer:

   res.status(400).json({ errors: [{ msg: 'Invalid input' }] }) -> Option C

4. Quick Check:

   Use res.status(400).json with errors array [OK]

Hint: Use res.status(400).json({ errors: [...] }) for validation errors [OK]

Common Mistakes:

• Sending plain text instead of JSON
• Omitting the status code
• Using 200 status for errors

3. Given this Express route snippet, what will be the JSON response if the input validation fails?

app.post('/user', (req, res) => {
  const errors = [];
  if (!req.body.email) errors.push({ msg: 'Email is required' });
  if (errors.length > 0) {
    return res.status(400).json({ errors });
  }
  res.send('User created');
});

medium

A. {"error":"Email missing"} with status 400

B. {"errors":[{"msg":"Email is required"}]} with status 400

C. "User created" with status 200

D. Empty response with status 400

Solution

1. Step 1: Check validation logic for missing email

   If email is missing, an error object with msg 'Email is required' is added to errors array.

2. Step 2: Return JSON with errors array and status 400

   Since errors array is not empty, the response sends status 400 and JSON containing errors array.

3. Final Answer:

   {"errors":[{"msg":"Email is required"}]} with status 400 -> Option B

4. Quick Check:

   Validation fails -> 400 + errors array JSON [OK]

Hint: Errors array with messages sent with 400 status [OK]

Common Mistakes:

• Returning success message despite errors
• Wrong JSON key like 'error' instead of 'errors'
• Not setting status 400

4. Identify the bug in this Express validation error response code:

if (!req.body.name) {
  res.json({ errors: [{ msg: 'Name is required' }] });
  res.status(400);
}

medium

A. Status code must be set before sending response

B. Response should use res.send instead of res.json

C. Errors array should be a string, not an object

D. No bug, code is correct

Solution

1. Step 1: Check order of status and response methods

   res.status(400) must be called before sending the response to set status properly.

2. Step 2: Identify that res.json sends response immediately

   Calling res.json first sends the response with default status 200, so status(400) after has no effect.

3. Final Answer:

   Status code must be set before sending response -> Option A

4. Quick Check:

   Set status before res.json/send [OK]

Hint: Call res.status before res.json/send [OK]

Common Mistakes:

• Setting status after sending response
• Using res.send instead of res.json (not a bug but less clear)
• Not sending any status code

5. You want to send multiple validation errors in a consistent format in Express. Which code snippet correctly formats and sends these errors with HTTP 400 status?

const errors = [
  { field: 'email', message: 'Invalid email' },
  { field: 'password', message: 'Password too short' }
];
// What is the correct response code?

hard

A. res.status(400).json({ errorMessages: errors })

B. res.json({ errors })

C. res.status(200).json({ errors })

D. res.status(400).json({ errors: errors.map(e => ({ msg: e.message, param: e.field })) })

Solution

1. Step 1: Map errors to standard format with msg and param keys

   Express validation errors usually have 'msg' for message and 'param' for field name.

2. Step 2: Send response with status 400 and JSON containing errors array

   Use res.status(400).json(...) to send proper status and formatted errors.

3. Final Answer:

   res.status(400).json({ errors: errors.map(e => ({ msg: e.message, param: e.field })) }) -> Option D

4. Quick Check:

   Map errors to {msg, param} and send with 400 status [OK]

Hint: Map errors to {msg, param} and send with status 400 [OK]

Common Mistakes:

• Sending errors without mapping keys
• Using 200 status for errors
• Using wrong JSON key like errorMessages