# statuses > HTTP status utility Latest version **2.0.2** (published 2025-06-06) · MIT license · 0 weekly downloads ## Install ```sh npm install statuses pnpm add statuses yarn add statuses bun add statuses ``` ## Health **Score 43/100 (D)** — status: stable. Positive: has types package; no vulnerabilities; high quality score. Warnings: low downloads; no esm support. Negative: stale. ## Facts | | | |---|---| | Version | 2.0.2 | | Published | 2025-06-06 | | First published | 2014-03-13 | | Weekly downloads | 0 | | License | MIT | | TypeScript types | separate (@types/statuses) | | Module format | CommonJS | | Node | >= 0.8 | | Dependencies | 0 | | Unpacked size | 12.2 KB | | Known vulnerabilities | 0 | | Install scripts | no | | GitHub stars | 282 | | Maintainers | ulisesgascon, blakeembrey, dougwilson, jongleberry | | Keywords | http, status, code | ## Links - npm: https://www.npmjs.com/package/statuses - Repository: https://github.com/jshttp/statuses - Homepage: https://github.com/jshttp/statuses#readme - Issues: https://github.com/jshttp/statuses/issues - npm.io page: https://npm.io/package/statuses ## Alternatives - [flatbuffers](https://npm.io/package/flatbuffers.md) — 6.0M weekly downloads - [jwt-simple](https://npm.io/package/jwt-simple.md) — 259.5K weekly downloads - [@exodus/patch-broken-hermes-typed-arrays](https://npm.io/package/@exodus/patch-broken-hermes-typed-arrays.md) — 28.5K weekly downloads - [@native-to-anchor/buffer-layout](https://npm.io/package/@native-to-anchor/buffer-layout.md) — 12.2K weekly downloads - [binary-parser-encoder](https://npm.io/package/binary-parser-encoder.md) — 5.3K weekly downloads ## Recent versions - 2.0.2 (latest) — 2025-06-06 - 2.0.1 — 2021-01-03 - 2.0.0 — 2020-04-19 - 1.5.0 — 2018-03-28 - 1.4.0 — 2017-10-20 - 1.3.1 — 2016-11-12 - 1.3.0 — 2016-05-17 - 1.2.1 — 2015-02-01 - 1.2.0 — 2014-09-29 - 1.1.1 — 2014-09-25 - 1.1.0 — 2014-09-22 - 1.0.4 — 2014-08-21 - 1.0.3 — 2014-06-09 - 1.0.2 — 2014-03-14 - 1.0.1 — 2014-03-13 ## README # statuses [![NPM Version][npm-version-image]][npm-url] [![NPM Downloads][npm-downloads-image]][npm-url] [![Node.js Version][node-version-image]][node-version-url] [![Build Status][ci-image]][ci-url] [![Test Coverage][coveralls-image]][coveralls-url] [![OpenSSF Scorecard Badge][ossf-scorecard-badge]][ossf-scorecard-visualizer] HTTP status utility for node. This module provides a list of status codes and messages sourced from a few different projects: * The [IANA Status Code Registry](https://www.iana.org/assignments/http-status-codes/http-status-codes.xhtml) * The [Node.js project](https://nodejs.org/) * The [NGINX project](https://www.nginx.com/) * The [Apache HTTP Server project](https://httpd.apache.org/) ## Installation This is a [Node.js](https://nodejs.org/en/) module available through the [npm registry](https://www.npmjs.com/). Installation is done using the [`npm install` command](https://docs.npmjs.com/getting-started/installing-npm-packages-locally): ```sh $ npm install statuses ``` ## API ```js var status = require('statuses') ``` ### status(code) Returns the status message string for a known HTTP status code. The code may be a number or a string. An error is thrown for an unknown status code. ```js status(403) // => 'Forbidden' status('403') // => 'Forbidden' status(306) // throws ``` ### status(msg) Returns the numeric status code for a known HTTP status message. The message is case-insensitive. An error is thrown for an unknown status message. ```js status('forbidden') // => 403 status('Forbidden') // => 403 status('foo') // throws ``` ### status.codes Returns an array of all the status codes as `Integer`s. ### status.code[msg] Returns the numeric status code for a known status message (in lower-case), otherwise `undefined`. ```js status['not found'] // => 404 ``` ### status.empty[code] Returns `true` if a status code expects an empty body. ```js status.empty[200] // => undefined status.empty[204] // => true status.empty[304] // => true ``` ### status.message[code] Returns the string message for a known numeric status code, otherwise `undefined`. This object is the same format as the [Node.js http module `http.STATUS_CODES`](https://nodejs.org/dist/latest/docs/api/http.html#http_http_status_codes). ```js status.message[404] // => 'Not Found' ``` ### status.redirect[code] Returns `true` if a status code is a valid redirect status. ```js status.redirect[200] // => undefined status.redirect[301] // => true ``` ### status.retry[code] Returns `true` if you should retry the rest. ```js status.retry[501] // => undefined status.retry[503] // => true ``` ## License [MIT](LICENSE) [ci-image]: https://badgen.net/github/checks/jshttp/statuses/master?label=ci [ci-url]: https://github.com/jshttp/statuses/actions?query=workflow%3Aci [coveralls-image]: https://badgen.net/coveralls/c/github/jshttp/statuses/master [coveralls-url]: https://coveralls.io/r/jshttp/statuses?branch=master [node-version-image]: https://badgen.net/npm/node/statuses [node-version-url]: https://nodejs.org/en/download [npm-downloads-image]: https://badgen.net/npm/dm/statuses [npm-url]: https://npmjs.org/package/statuses [npm-version-image]: https://badgen.net/npm/v/statuses [ossf-scorecard-badge]: https://api.securityscorecards.dev/projects/github.com/jshttp/statuses/badge [ossf-scorecard-visualizer]: https://kooltheba.github.io/openssf-scorecard-api-visualizer/#/projects/github.com/jshttp/statuses --- _Source: https://npm.io/package/statuses · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._