http-status-toolkit

👉 View on npm

A simple and lightweight toolkit for HTTP status codes and messages — written in TypeScript for safe, reliable usage.

If you like the project, please give the project a GitHub ⭐

---

What is this?

This package gives you:

• HTTP status codes as constants (like StatusCodes.OK for 200)
• Short and clear messages for each status code
• Longer, more detailed messages if you want extra info
• Localization support for 10+ languages
• A helper function (getStatusMessage) to fetch messages by status code
• Full TypeScript support for better coding experience

---

🚀 Installation Guide

You can install http-status-toolkit using your favorite package manager.

Using npm

npm install http-status-toolkit

Using yarn

yarn add http-status-toolkit

Using pnpm

pnpm add http-status-toolkit

TypeScript & Module Support

• ✅ Full TypeScript support with type safety and autocompletion
• ✅ Works in both ESM and CommonJS environments

---

How to use

import {
  StatusCodes,
  getStatusMessage,
} from 'http-status-toolkit';

// Get the status code number
console.log(StatusCodes.OK); // 200

// Get a short message (default)
console.log(getStatusMessage(StatusCodes.NOT_FOUND));
// Output: "Not Found"

// Get a detailed message (import detailed messages and pass variant)
import DetailedMessages from 'http-status-toolkit/messages-detailed';
console.log(getStatusMessage(StatusCodes.NOT_FOUND, { variant: DetailedMessages }));
// Output: "Not Found: The requested resource could not be found but may be available in the future."

// Get a localized message (import a language variant)
import BengaliMessages from 'http-status-toolkit/messages-bn';
console.log(getStatusMessage(StatusCodes.NOT_FOUND, { variant: BengaliMessages }));
// Output: (Not Found message in Bengali)

---

What’s included?

• StatusCodes: constants for all HTTP status codes
• StatusMessages: short messages for each code (English default)
• DetailedStatusMessages: longer, more detailed English messages
• getStatusMessage(code, options?): returns the message for a status code; optionally pass a { variant } to get localized or detailed messages

Note:
getStatusMessage returns the HTTP reason phrase for a status code.
You can also use the alias getReasonPhrase, which behaves the same way.

---

Common HTTP Status Codes

Code	Constant	Message
200	OK	Request OK
201	CREATED	Resource created
400	BAD_REQUEST	Bad input
401	UNAUTHORIZED	Auth required
403	FORBIDDEN	Access denied
404	NOT_FOUND	Not found
500	SERVER_ERROR	Server crashed

🔗 See full list of status codes
🔗 See status codes with detailed messages

---

Supported Languages (Localization)

You can import message variants for different languages:

Language	Import Path	Docs File
English (default)	—	—
Detailed English	messages-detailed	detailed-status-messages.md
Bengali	messages-bn	bengali-status-messages.md
Chinese	messages-zh	chinese-status-messages.md
Hindi	messages-hi	hindi-status-messages.md
Arabic	messages-ar	arabic-status-messages.md
German	messages-de	german-status-messages.md
French	messages-fr	french-status-messages.md
Italian	messages-it	italian-status-messages.md
Spanish	messages-es	spanish-status-messages.md
Japanese	messages-ja	japanese-status-messages.md
Russian	messages-ru	russian-status-messages.md

---

Contributors

Thanks to everyone who has contributed to this project! Special thanks to:

• Rocky Haque — for their valuable pull request(s)

Contributions of any kind are always welcome. Feel free to open issues or submit PRs!

---

License

MIT License. See the LICENSE file.

---

Contributions

Feel free to suggest improvements or add new status codes by opening issues or pull requests on GitHub.

---

Links

• GitHub: https://github.com/dev-rashedin/http-status-toolkit
• Portfolio: https://www.rashedin.dev

---

Made with ❤️ by Rashedin Islam